# Get Interview

## List All Interviews

> Retrieve a list of interviews with optional filters.

OpenAPI:

```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"}}},"paths":{"/api/v1/interview/get-interviews":{"get":{"tags":["Interview"],"summary":"List All Interviews","description":"Retrieve a list of interviews with optional filters.","operationId":"listInterviews","parameters":[{"in":"query","name":"status","schema":{"type":"string","enum":["draft","published","completed"]}},{"in":"query","name":"page","schema":{"type":"integer"}},{"in":"query","name":"limit","schema":{"type":"integer"}},{"in":"query","name":"search","description":"Search by interview name or any other detail in the metadata","schema":{"type":"string"}}],"responses":{"200":{"description":"A list of interviews","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"message":{"type":"string"},"success":{"type":"boolean"},"data":{"type":"object","description":"Actual response data object"}}},{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"interviewId":{"type":"string"},"interviewName":{"type":"string"},"roleName":{"type":"string"},"minExperience":{"type":"integer"},"maxExperience":{"type":"integer"},"jdType":{"type":"string","enum":["text","link"]},"sampleQuestions":{"type":"array","items":{"type":"string"}},"interviewConfig":{"type":"object","properties":{"redirectUrl":{"type":"string","format":"uri"},"allowAccess":{"type":"string","enum":["anyone","scheduledCandidates"]},"allowLateAttempts":{"type":"boolean"},"allowContinueFromMiddle":{"type":"boolean"},"allowContinueFromMiddleCount":{"type":"integer"},"allowReattempt":{"type":"boolean"},"allowReattemptCount":{"type":"integer"},"allowInterviewOnMobile":{"type":"boolean"},"allowScreenLeaveCount":{"type":"integer"},"allowTabSwitchCount":{"type":"integer"},"webhookUrl":{"type":"string","format":"uri"}}},"interviewLink":{"type":"string","nullable":true},"competencyData":{"type":"array","items":{"type":"object","properties":{"competency":{"type":"string"},"explanation":{"type":"string"},"difficulty":{"type":"string"},"questionType":{"type":"string"},"questionCount":{"type":"integer"},"time":{"type":"integer"},"category":{"type":"string"},"sampleQuestions":{"type":"array","items":{"type":"string"}}}}},"metaData":{"type":"object","properties":{"Id":{"type":"integer"},"name":{"type":"string"},"clientId":{"type":"integer"}}},"status":{"type":"string","enum":["draft","published","completed"]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}}}}}]}}}},"401":{"description":"Missing or invalid Authorization header","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"success":{"type":"boolean"},"error":{"nullable":true,"description":"Error details: Error Message"}},"required":["message","success","error"]}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","properties":{"$ref":"#/paths/~1api~1v1~1interview~1get-interviews/get/responses/401/content/application~1json/schema/properties"},"required":["message","success","error"]}}}}}}}}}
```

## Get Interview by ID

> Fetch detailed information for a single interview.

OpenAPI:

```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"}}},"paths":{"/api/v1/interview/get-interview/{id}":{"get":{"tags":["Interview"],"summary":"Get Interview by ID","description":"Fetch detailed information for a single interview.","operationId":"getInterviewById","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"},"description":"The interview ID"}],"responses":{"200":{"description":"Interview details","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"message":{"type":"string"},"success":{"type":"boolean"},"data":{"type":"object","description":"Actual response data object"}}},{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object","properties":{"interviewId":{"type":"string"},"interviewName":{"type":"string"},"roleName":{"type":"string"},"minExperience":{"type":"integer"},"maxExperience":{"type":"integer"},"jdType":{"type":"string","enum":["text","link"]},"sampleQuestions":{"type":"array","items":{"type":"string"}},"competencyData":{"type":"array","items":{"type":"object","properties":{"competency":{"type":"string"},"explanation":{"type":"string"},"difficulty":{"type":"string"},"questionType":{"type":"string"},"questionCount":{"type":"integer"},"time":{"type":"integer"},"category":{"type":"string"},"sampleQuestions":{"type":"array","items":{"type":"string"}}}}},"interviewConfig":{"type":"object","properties":{"redirectUrl":{"type":"string","format":"uri"},"allowAccess":{"type":"string","enum":["anyone","scheduledCandidates"]},"allowLateAttempts":{"type":"boolean"},"allowContinueFromMiddle":{"type":"boolean"},"allowContinueFromMiddleCount":{"type":"integer"},"allowReattempt":{"type":"boolean"},"allowReattemptCount":{"type":"integer"},"allowInterviewOnMobile":{"type":"boolean"},"allowScreenLeaveCount":{"type":"integer"},"allowTabSwitchCount":{"type":"integer"},"webhookUrl":{"type":"string","format":"uri"}}},"metaData":{"type":"object","additionalProperties":true},"status":{"type":"string","enum":["draft","published","completed"]},"interviewLink":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}}}}]}}}},"401":{"description":"Missing or invalid Authorization header","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"success":{"type":"boolean"},"error":{"nullable":true,"description":"Error details: Error Message"}},"required":["message","success","error"]}}}},"404":{"description":"Interview not found","content":{"application/json":{"schema":{"type":"object","properties":{"$ref":"#/paths/~1api~1v1~1interview~1get-interview~1{id}/get/responses/401/content/application~1json/schema/properties"},"required":["message","success","error"]}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","properties":{"$ref":"#/paths/~1api~1v1~1interview~1get-interview~1{id}/get/responses/401/content/application~1json/schema/properties"},"required":["message","success","error"]}}}}}}}}}
```
