Endpoints

All endpoints use the base URL https://app.talvin.ai/api/v1 and the authentication headers.

GET /whoami

Checks your credentials. Returns the API key’s id and name.

{ "success": true, "data": { "id": "0f4c1…", "name": "My Integration" } }

GET /interviews

Lists all interviews in your organization, newest first.

Field	Type	Description
id	string	Interview ID
name	string	Interview / role name
description	string	Interview description
question_count	number	Number of main questions
time_duration	string	Planned duration in minutes
questions	array	[{ id, question, follow_up_count }]
is_active	boolean	Whether the interview currently accepts candidates

[
  {
    "id": "GCV-5rn07_oOpQwsweQTv",
    "name": "Client Relationship Officer",
    "description": "Screening for the CRO voice-process role",
    "question_count": 5,
    "time_duration": "10",
    "questions": [
      { "id": "q1", "question": "Tell me about yourself", "follow_up_count": 1 }
    ],
    "is_active": true
  }
]

GET /interviews/{id}

Fetches a single interview by ID. Same fields as above, without is_active. Returns 404 if the interview doesn’t exist or belongs to another organization.

Note

For compatibility reasons this endpoint returns an array containing one interview, not a bare object.

GET /responses

Lists the 100 most recent candidate responses across all your interviews, newest first.

Field	Type	Description
id	number	Response ID
created_at	string	ISO 8601, when the candidate started
name	string	Candidate name
email	string	Candidate email
call_id	string	Voice call ID
duration	number	Call duration in seconds
candidate_status	string	NO_STATUS · POTENTIAL · SELECTED · NOT_SELECTED
interview	object	{ id, name, organization_id }

[
  {
    "id": 1014,
    "created_at": "2026-07-08T15:13:30.841Z",
    "name": "Vishnu Reddy",
    "email": "candidate@example.com",
    "call_id": "call_345249d369b0…",
    "duration": 189,
    "candidate_status": "NO_STATUS",
    "interview": {
      "id": "GCV-5rn07_oOpQwsweQTv",
      "name": "Client Relationship Officer",
      "organization_id": "org_3Fo3T4FzHW…"
    }
  }
]