Get Eval Run
Returns the eval run identified by its ID.
Authentication
AuthorizationBearer
Authenticate server-side requests with a private Vapi API key. Create or copy a key from the [Vapi Dashboard](https://dashboard.vapi.ai) and send it in the `Authorization` header as `Bearer <token>`. Keep private API keys out of client-side code and public repositories.
Path parameters
id
The unique identifier of the eval run.
Response
status
This is the status of the eval run. When an eval run is created, the status is 'running'.
When the eval run is completed, the status is 'ended'.
endedReason
This is the reason for the eval run to end.
When the eval run is completed normally i.e end of mock conversation, the status is 'mockConversation.done'.
When the eval fails due to an error like Chat error or incorrect configuration, the status is 'error'.
When the eval runs for too long, due to model issues or tool call issues, the status is 'timeout'.
When the eval run is cancelled by the user, the status is 'cancelled'.
When the eval run is cancelled by Vapi for any reason, the status is 'aborted'.
target
This is the target that will be run against the eval
id
The unique identifier for the eval run.
orgId
The unique identifier for the organization that owns the run.
createdAt
The ISO 8601 timestamp when the eval run was created.
startedAt
The ISO 8601 timestamp when the eval run started.
endedAt
The ISO 8601 timestamp when the eval run ended.
results
Results for this individual Eval. Check them after status is ended. An Eval that finishes normally contains one result; it passes only when all judged checkpoints pass. Grouping multiple Evals requires your own orchestration, not an Eval suite.
cost
The cost of this Eval run in USD.
costs
The cost breakdown for this Eval run.
type
This is the type of the run.
Currently it is fixed to eval.
eval
This is the transient eval that will be run
endedMessage
This is the ended message when the eval run ended for any reason apart from mockConversation.done
evalId
This is the id of the eval that will be run.