elmo
Sign up

Get a run

GET
/prompts/{promptId}/runs/{runId}

One model answer, with its text normalized out of the provider’s response and its citations in the order the engine listed them. A run belonging to some other prompt answers 404. The provider’s raw payload is deliberately not exposed — its shape belongs to the provider, not to this API.

Authorization

BearerAuth
headerAuthorizationBearer <token>

An instance admin key from ADMIN_API_KEYS, or an organization key (elmo_…) issued from the dashboard.

Path Parameters

promptId*string
Formatuuid
runId*string
Formatuuid

Response Body

Get a run

application/json
  1. response

One model answer with its normalized text and citations.

id*string
Formatuuid
promptId*string
Formatuuid
brandId*string
model*string
provider*|

How the answer was obtained. Informational; not a stable enum.

webSearchEnabled*boolean

Whether the engine answered with its own web search on.

brandMentioned*boolean
competitorsMentioned*array<string>
assessments*|

Experimental — the shape may still change.

The mention judge's assessments for one answer. Null when the run's mentions were matched by name, before the judge, until a replay judges it.

webQueries*array<string>

Searches the engine ran, where it exposes them.

citationCount*integer
createdAt*string
Formatdate-time
answer*
citations*array<>
curl -X GET 'https://app.elmohq.com/api/v1/prompts/497f6eca-6276-4993-bfeb-53cbbbba6f08/runs/497f6eca-6276-4993-bfeb-53cbbbba6f08'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "promptId": "b5415d63-4390-40ec-8c2b-33a2db2f5c67",  "brandId": "string",  "model": "string",  "provider": "string",  "webSearchEnabled": true,  "brandMentioned": true,  "competitorsMentioned": [    "string"  ],  "assessments": {    "brand": {      "mentioned": true,      "probability": 0,      "reason": "string",      "sentiment": "positive",      "sentimentProbabilities": {        "property1": 0,        "property2": 0      },      "position": 1,      "mentionCount": 1    },    "competitors": {      "property1": {        "mentioned": true,        "probability": 0,        "reason": "string",        "sentiment": "positive",        "sentimentProbabilities": {          "property1": 0,          "property2": 0        },        "position": 1,        "mentionCount": 1      },      "property2": {        "mentioned": true,        "probability": 0,        "reason": "string",        "sentiment": "positive",        "sentimentProbabilities": {          "property1": 0,          "property2": 0        },        "position": 1,        "mentionCount": 1      }    }  },  "webQueries": [    "string"  ],  "citationCount": 0,  "createdAt": "2019-08-24T14:15:22Z",  "answer": {    "text": "string"  },  "citations": [    {      "url": "http://example.com",      "domain": "string",      "title": "string",      "citationIndex": 0    }  ]}