Skip to main content
GET
/
v1
/
call-logs
List Call Logs
curl --request GET \
  --url https://api.example.com/v1/call-logs

Documentation Index

Fetch the complete documentation index at: https://docs.reachedapp.com/llms.txt

Use this file to discover all available pages before exploring further.

​
List Call Logs

Returns a paginated list of call logs with optional filters. Use this endpoint to retrieve call results, dispositions, and recordings.

​
Request

GET /v1/call-logs

​
Query Parameters

ParameterTypeRequiredDescription
pageintegerNoPage number (default: 1)
per_pageintegerNoResults per page, max 100 (default: 25)
lead_iduuidNoFilter by lead ID
campaign_iduuidNoFilter by campaign ID
dispositionstringNoFilter by disposition (e.g., meeting_booked, not_interested)
date_fromstringNoStart date in ISO 8601 format (e.g., 2026-03-01T00:00:00Z)
date_tostringNoEnd date in ISO 8601 format

​
Example

curl -X GET \
  "https://YOUR_PROJECT.supabase.co/functions/v1/api-gateway/v1/call-logs?campaign_id=c1d2e3f4-...&date_from=2026-03-01T00:00:00Z" \
  -H "Authorization: Bearer rchd_live_xxxxxxxxxxxx"

​
Response

{
  "data": [
    {
      "id": "log-uuid-1",
      "lead_id": "a1b2c3d4-...",
      "campaign_id": "c1d2e3f4-...",
      "from_number": "+33140000000",
      "to_number": "+33612345678",
      "duration": 145,
      "status": "completed",
      "disposition": "meeting_booked",
      "recording_url": "https://...",
      "started_at": "2026-03-21T14:30:00.000Z",
      "ended_at": "2026-03-21T14:32:25.000Z"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 25,
    "total": 1
  }
}

​
Response Fields

FieldTypeDescription
iduuidCall log unique identifier
lead_iduuidAssociated lead ID
campaign_iduuidAssociated campaign ID
from_numberstringCaller phone number
to_numberstringCalled phone number
durationintegerCall duration in seconds
statusstringCall status (completed, no-answer, busy, failed)
dispositionstringCall outcome disposition
recording_urlstringURL to the call recording (if available)
started_atdatetimeCall start timestamp
ended_atdatetimeCall end timestamp

​
Disposition Values

DispositionDescription
meeting_bookedMeeting or demo scheduled
appointment_scheduledAppointment confirmed
callback_requestedLead requested a callback
not_interestedLead not interested
no_answerNo one answered
voicemailReached voicemail
voicemail_leftVoicemail message left
wrong_numberWrong number
wrong_personWrong contact
gatekeeperBlocked by gatekeeper
no_longer_at_companyContact left the company
abandoned_callCall abandoned
voice_assistant_filteredFiltered by voice assistant