Skip to main content
The Kovi REST API gives you full programmatic control over interview scheduling and scorecard retrieval. All requests use HTTPS, and all responses are JSON.

​
Base URL

Every API request is made to the following base URL:

​
Authentication

All requests require your API key in the Authorization header:
See the Authentication page for full details on obtaining and managing your API key.

​
Request Format

For POST requests, send a JSON body and include the Content-Type header:
Pass all parameters as a JSON object in the request body.

​
Response Format

All responses return JSON. Successful responses include the requested resource object. Failed responses include the following error fields: Example error response:

​
Rate Limits

Standard rate limiting applies to all API endpoints. If you exceed your rate limit, the API returns a 429 Too Many Requests response. Contact support@techeval.ai to request a higher rate limit for your account.

​
Available Endpoints

Schedule Interview

POST /interviewsCreate a new interview session for a candidate and get a shareable interview URL.

Retrieve Interview

GET /interviews/{interview_id}Fetch the current status and metadata for a specific interview session.

List Interviews

GET /interviewsRetrieve a paginated list of all interview sessions for your account.

Get Scorecard

GET /scorecards/{candidate_id}Fetch the full evaluation scorecard for a completed interview.

Get Transcript

GET /transcripts/{candidate_id}Retrieve the full question-and-answer transcript URL for a completed interview.
The Python SDK (kovi-sdk) wraps these REST endpoints. Use the SDK for simpler integration — install it with pip install kovi-sdk.