This set of endpoints helps manage the calls, getting their summary and other details.
Initiate an instant call for an application
Trigger an immediate phone call for a candidate associated with a specific application using the application ID. This endpoint is typically used to initiate an interview or contact attempt directly through the system.
path Parameters
application_idstring · requiredThe ID of the application for which the instant call is triggered
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Responses
Instant call triggered successfully
statusstringStatus of the call trigger
call_idstringUnique ID of the triggered call
Retrieve call details for a specific call
The Call detail endpoint provides details about a specific call, including its status, intelligence assessment, summary, transcript, and detailed question responses.
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Responses
Successful response containing complete details of the call.
call_idstring · requiredUnique identifier for the call.
call_statusstring · enum · requiredThe status of the call.
Enum values:call_completedcall_in_progresscall_failedninjahire_intelligencestring · enum · requiredThe intelligence assessment of the call.
Enum values:call_successcall_failedcall_inconclusive
call_directionstring · enumDirection of the call.
Enum values:outgoingincomingrecording_urlstring · uriThe URL to the recording of the call.
call_scoreinteger · min: 0 · max: 100The overall score of the call assessment (0-100).
call_summaryobjectDetailed breakdown of the call assessment by category.
call_digeststringA comprehensive summary of the call assessment and candidate evaluation.
transcriptstringFull transcript of the call conversation with speaker labels (BOT/HUMAN).
questions_responsestringJSON string array containing individual questions, responses, and their scores.
Retrieve screening call results
Get AI screening call results for applications. Use this after get_applications to retrieve the full screening report for any application where screening_status is 'completed'. Pass the application 'id' from get_applications as application_id here. Returns the call score, category breakdown, full transcript, and per-question scores.
query Parameters
pageinteger · min: 1 · requiredPage number. MUST start at 1, never 0.
Default: 1sizeinteger · min: 1 · max: 100 · requiredNumber of items per page (default: 10)
Default: 10application_idstringPRIMARY filter — the application UUID from get_applications results (the 'id' field). Always use this when you have the application UUID. Only use this for applications with screening_status='completed'.
job_idstringFilter by job UUID
candidate_idstringFilter by candidate UUID
application_source_idstringFilter by the external source system ID of the application. Do NOT use this when you have the application UUID — use application_id instead.
job_source_idstringFilter by source ID of the job
candidate_source_idstringFilter by source ID of the candidate
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Responses
Screening call results
dataobject[]countintegerTotal number of calls matching the query