RinghouseAPI reference
Get started

Calls

List calls

List the workspace's calls, newest first.

GET/v1/calls

Needs the calls:read scope.

Query parameters

limitinteger
1–100, default 25.
cursorstring
The `nextCursor` from a previous response.
idsstring
Fetch specific items by id, comma separated, up to 100. Overrides paging when given.

Returns

A page of calls. The items are in data, and nextCursor fetches the next page. A failed call answers with an error instead.

idstring
createdAtstring
directionCallDirection
inbound | outbound.
durationintegernullable
Talk time in seconds; null while the call is still up.
endedAtstringnullable
fromstringnullable
hasRecordingboolean
Whether the call left a recording, summary or transcript to fetch.
hasSummaryboolean
hasTranscriptboolean
isVoicemailboolean
missedboolean
numberIdstringnullable
Null for a teammate-to-teammate call, which never touches a number.
startedAtstringnullable
statusstring
tostringnullable
curl https://api.ringhouse.ai/v1/calls \
  -H "Authorization: Bearer rh_live_xxxxxxxx"
{
  "data": [
    {
      "id": "4b1a8d2e-6c3f-47b9-8e05-d91a2c7f6b34",
      "createdAt": "2026-09-25T14:02:11Z",
      "direction": "inbound",
      "duration": 184,
      "endedAt": "2026-09-25T14:05:15Z",
      "from": "+447700900123",
      "hasRecording": false,
      "hasSummary": false,
      "hasTranscript": false,
      "isVoicemail": false,
      "missed": false,
      "numberId": "3f9c1a2e-7b4d-4c8e-9a1f-5d2e8b6c0a41",
      "startedAt": "2026-09-25T14:02:11Z",
      "status": "completed",
      "to": "+441134960000"
    }
  ],
  "nextCursor": "MjAyNi0wOS0yNVQxNDowMjoxMVp8M2Y5YzFhMmU"
}
Was this page helpful?
Previous← Get a messageNextGet a call