> For the complete documentation index, see [llms.txt](https://zeko.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zeko.gitbook.io/docs/zekoai-api-docs/api-reference/interview-result/get-interview-results.md).

# Get Interview Results

## Get Results for an Interview

> Retrieve the results for all candidates of a specific interview.

```json
{"openapi":"3.0.3","info":{"title":"ZekoAI Interview APIs","version":"1.0.0"},"servers":[{"url":"https://interview-api.zeko.ai","description":"Production Server"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GetInterviewResultsResponse":{"allOf":[{"$ref":"#/components/schemas/SuccessWrapper"},{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"interviewId":{"type":"string"},"candidate":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string","format":"email"}}},"scores":{"type":"object","properties":{"overallScore":{"type":"integer"},"technicalScore":{"type":"integer"},"communicationScore":{"type":"integer"}}},"metaData":{"type":"object","properties":{"Id":{"type":"integer"},"name":{"type":"string"},"clientId":{"type":"integer"}}},"reportLink":{"type":"string","format":"uri"}}}}}}]},"SuccessWrapper":{"type":"object","properties":{"message":{"type":"string"},"success":{"type":"boolean"},"data":{"type":"object","description":"Actual response data object"}}},"ErrorWrapper":{"type":"object","properties":{"message":{"type":"string"},"success":{"type":"boolean"},"error":{"nullable":true,"description":"Error details: Error Message"}},"required":["message","success","error"]},"ValidationErrorWrapper":{"type":"object","properties":{"message":{"type":"string"},"success":{"type":"boolean"},"error":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}}}}},"required":["message","success","error"]}}},"paths":{"/api/v1/interview/{id}/results":{"get":{"tags":["Results"],"summary":"Get Results for an Interview","description":"Retrieve the results for all candidates of a specific interview.","operationId":"getInterviewResults","parameters":[{"in":"path","name":"id","schema":{"type":"string"},"required":true,"description":"The interview ID"},{"in":"query","name":"page","schema":{"type":"integer"}},{"in":"query","name":"limit","schema":{"type":"integer"}},{"in":"query","name":"search","schema":{"type":"string"},"description":"Search by name, email, phone, or metaData"}],"responses":{"200":{"description":"Results retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetInterviewResultsResponse"}}}},"401":{"description":"Missing or invalid Authorization header","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorWrapper"}}}},"404":{"description":"Interview not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorWrapper"}}}},"422":{"description":"Input Validation failed (e.g. results not ready)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorWrapper"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorWrapper"}}}}}}}}}
```
