List calls | Saperly Docs

const url = 'https://saperly.com/api/v1/calls';
const options = {
  method: 'GET',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{}'
};
try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

{
  "calls": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "line_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "direction": "inbound",
      "from_number": "+14155552671",
      "to_number": "+14155559876",
      "status": "initiated",
      "duration_sec": 45,
      "started_at": "2024-01-15T09:30:00Z",
      "ended_at": "2024-01-15T09:31:00Z",
      "recording_url": "https://saperly.com/recordings/3fa85f64-5717-4562-b3fc-2c963f66afa6.mp3",
      "transcript": [
        {
          "speaker": "agent",
          "text": "Hello, how can I assist you today?",
          "timestamp": "2024-01-15T09:30:05Z"
        },
        {
          "speaker": "caller",
          "text": "I need help with my account.",
          "timestamp": "2024-01-15T09:30:10Z"
        }
      ],
      "system_prompt": "Welcome to Saperly support. Please state your issue.",
      "begin_message": "Connecting your call now.",
      "created_at": "2024-01-15T09:29:55Z"
    }
  ],
  "total": 1
}

Returns calls for the authenticated user with optional filtering.

Authentication

AuthorizationBearer

Send as Authorization: Bearer <your-key>. Obtain keys from the portal — prefix sk_live_ for production, sk_test_ for sandbox.

Query parameters

line_idstringOptionalformat: "uuid"

Filter by line ID

statusenumOptional

Filter by call status

limitintegerOptional1-100Defaults to 50

Maximum number of results (1-100)

offsetintegerOptional>=0Defaults to 0

Number of results to skip

Response

List of calls

callslist of objects

totalinteger

Total number of matching calls

Errors

401

Unauthorized Error