Calls
List calls
Returns the calls your API key can access, newest first. A key scoped to All agents returns calls from every agent in your company; a key scoped to Specific agents returns only calls handled by the agents linked to that key.
Authentication
AuthorizationBearerAuthenticate server-side requests with a Fonema API key. Create one in the API keys section of the Dashboard and send it in the Authorization header as Bearer <token>. Keep keys out of client-side code and public repositories.
Query parameters
pageintegerOptionalDefaults to 1Page number to retrieve (1-based). Values below 1 fall back to 1.
limitintegerOptionalDefaults to 20Number of calls per page. Maximum 100.
agentstringOptionalOnly return calls handled by the agent with this slug. Returns 404 if the slug doesn't exist or isn't accessible by this key.
startDatestringOptionalOnly return calls created on or after this date (ISO 8601, e.g. 2026-08-01). Must be sent together with endDate.
endDatestringOptionalOnly return calls created on or before this date (ISO 8601). Must be sent together with startDate.
Response
totalintegerlimitintegeroffsetintegercurrentPageintegertotalPagesintegercallsarraycalls[].uidstringUnique call identifier. Use it with Get call.
calls[].agentobjectname and slug).calls[].toNumberstringcalls[].endedReasonstringcustomer-ended-call, voicemail).calls[].createdAtstringcalls[].startAtstring | nullnull if it never connected.calls[].endAtstring | nullcalls[].durationSecondsinteger0 if the call never connected.calls[].successEvaluationbooleancalls[].inputDataobjectThe variables provided when the call was created (e.g. via Start a call).
Use the uid returned here as the identifier for Get call requests.
Errors
404agent slug doesn't exist or isn't accessible by this API key.