List Call Recordings — Shilo API GET /api/v1/calls

This endpoint returns a paginated list of call recordings associated with your Shilo organization. Only non-roleplay calls are returned. You can narrow results using filters for the owning agent, associated contact, sales stage, recording source, or creation date range. Results are returned in cursor-based pages to support efficient traversal of large datasets.

Endpoint

GET https://api.shilo.ai/api/v1/calls

Query Parameters

number

Maximum number of call records to return in a single page. Defaults to 50. Maximum allowed value is 100.

string

Opaque pagination cursor returned as next_cursor in a previous response. Pass this value to retrieve the next page of results. Omit to start from the beginning.

string

Sort order for results by creation date. Accepts "asc" (oldest first) or "desc" (newest first). Defaults to "asc".

string

Return only calls created on or after this timestamp. Must be a valid ISO-8601 datetime string (e.g. 2030-01-01T00:00:00Z).

string

Return only calls created on or before this timestamp. Must be a valid ISO-8601 datetime string. Use together with created_date_gte to define a date range.

string

Filter calls by their recording source ID. Corresponds to source_id on the Call object.

string

Filter calls by the agent who owns them. Supports three formats:

{uuid} — Shilo User UUID directly
id:{uuid} — explicit Shilo UUID prefix
external_user_id:{value} — your own system’s agent identifier

string

Filter calls by the associated contact. Supports three formats:

{uuid} — Shilo Contact UUID directly
id:{uuid} — explicit Shilo UUID prefix
external_contact_id:{value} — your own system’s contact identifier

string

Filter calls by the sales stage ID associated with the contact at the time of the call.

Response

A successful request returns HTTP 200 with a CallsResponseDto object containing a data array of Call objects and a pagination object.

array

Array of Call objects matching the query.

Show Call object fields

string

Shilo’s unique UUID for this call recording.

string

Resource type identifier. Always "call" for this endpoint.

string

ISO-8601 timestamp of when the call was ingested by Shilo.

number

Length of the call in seconds.

string

Your system’s identifier for the agent on this call.

string

Shilo’s UUID for the agent on this call.

string

Your system’s identifier for the contact on this call.

string

Shilo’s UUID for the contact on this call.

string

The phone number the call originated from, in display format.

string

The phone number the call was placed to, in display format.

boolean

true if the call was inbound (received by the agent); false if outbound.

string

Human-readable name of the recording source (e.g. "Broker").

string

Identifier of the recording source.

string

Human-readable sales stage associated with the contact at call time.

string

Identifier of the associated sales stage.

string

The recording_id your system supplied when this call was submitted via POST /calls.

object

Pagination metadata for iterating through large result sets.

Show Pagination fields

boolean

true if there are additional pages of results beyond the current page.

string

Opaque cursor string to pass as the cursor query parameter to retrieve the next page. null when has_more is false.

Example Response

{
  "data": [
    {
      "id": "ee6f2136-b94a-4438-9335-3acf5b2a0d31",
      "type": "call",
      "created_date": "2030-09-24T12:34:56Z",
      "duration": 120,
      "external_user_id": "432",
      "user_id": "ee6f2136-b94a-4438-9335-3acf5b2a0d31",
      "external_contact_id": "4534",
      "contact_id": "ee6f2136-b94a-4438-9335-3acf5b2a0d31",
      "from_number": "(555) 555-1234",
      "to_number": "(555) 555-5678",
      "incoming": true,
      "source": "Broker",
      "source_id": "80",
      "stage": "Agents",
      "stage_id": "60",
      "external_recording_id": "ext-123"
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "eyJjcmV..."
  }
}

Example Request

curl --request GET \
  --url "https://api.shilo.ai/api/v1/calls?limit=50&sort=desc&created_date_gte=2030-01-01T00:00:00Z" \
  --header "x-api-key: YOUR_API_KEY"

Error Responses

401 Unauthorized — Returned when the API key is missing or invalid. Missing x-api-key (or Authorization: Bearer) header:

{
  "error": "unauthorized",
  "message": "Missing API key"
}

Unrecognized or revoked key:

{
  "error": "unauthorized",
  "message": "Invalid API key"
}

Overview

Calls

Appointments

Roleplays

Contacts

Users

Invitations

Metrics

Coaching

List Call Recordings — Shilo API GET /api/v1/calls

Endpoint

Query Parameters

Response

Example Response

Example Request

Error Responses

​Endpoint

​Query Parameters

​Response

​Example Response

​Example Request

​Error Responses

Endpoint

Query Parameters

Response

Example Response

Example Request

Error Responses