Skip to Content
Voice AgentCall Logs

Call Logs

POST/api/app/voice-agent/call-log
Queries voice agent call logs. Returns results filtered by date range, phone number, call ID, status and limit. Only records that belong to the token owner's tenant are listed.

Request Body

{ "assistant": "test", "startDate": "2026-04-01T09:19:52.328Z", "endDate": "2026-04-14T09:19:52.328Z", "limit": 25 }

Parameters

FieldTypeRequiredDescription
assistantstringYesThe assistant whose logs will be queried.
startDatedatetimeYesStart date of the filter. Must be sent in ISO 8601 format.
endDatedatetimeYesEnd date of the filter. Must be sent in ISO 8601 format and must be later than startDate.
phoneNumberstringNoPhone number to filter by.
call_idstringNoCall ID used to fetch the logs of a specific call.
limitintNoNumber of records to return. If provided, must be between 1 and 1000.
statusstringNoFilters by call status. E.g. completed, failed, in-progress.

Responses

200Success
{ "success": true, "message": null, "data": [ { "id": "019e925a-5f79-7778-b0be-a45a146cf828", "assistantId": "1a96b945-d104-4b64-b96e-3153d8f54c85", "phoneNumberId": "00000000-0000-0000-0000-000000000000", "type": "outboundPhoneCall", "startedAt": "2026-04-10T14:35:12.000Z", "endedAt": "2026-04-10T14:41:47.000Z", "customer": { "name": null, "number": "+905xxxxxxxxx", "sipUri": null }, "status": "completed", "endedReason": "customer-ended-call", "is_interested": null, "contact_channel": null, "contact_time": null, "metadata": null } ] }
FieldTypeNullableDescription
idstringNoUnique identifier of the call.
assistantIdstringNoID of the assistant that ran the call.
phoneNumberIdstringYesID of the phone number used for the call. If the provider does not pass this information, an empty GUID (`00000000-0000-0000-0000-000000000000`) may be returned.
typestringNoCall type. E.g. outboundPhoneCall.
startedAtdatetimeNoDate and time the call started.
endedAtdatetimeYesDate and time the call ended. null if the call has not ended yet.
customerobjectNoInformation about the called customer. See the table below for subfields.
statusstringNoCall status. E.g. completed, failed, in-progress.
endedReasonstringYesReason the call ended. null if the provider did not report a reason.
is_interestedstringYesAnalysis result: whether the customer is interested. May be null depending on the provider.
contact_channelstringYesContact channel information. May be null depending on the provider.
contact_timestringYesContact time information. May be null depending on the provider.
metadatastringYesMetadata sent when the call was started. null if no metadata was sent.

customer Subfields

FieldTypeNullableDescription
namestringYesCustomer name. null if not defined at the provider.
numberstringNoPhone number of the called customer.
sipUristringYesSIP address for calls made over SIP. null for calls made to a phone number.

Because the fields inside data come from the assistant provider this endpoint is connected to (n8n integration), some fields may be empty depending on the provider. An empty field is usually returned as null (not as an empty string "").

The “Nullable” column reflects an expectation based on what each field means; the n8n integration does not enforce it with server-side validation. Fields marked “No” can therefore theoretically be empty as well, although this is not expected under normal conditions.

Last updated: