Calls

List calls

Returns a paginated list of calls made on the Nooks SEP. Supports filtering by ID and updatedAt range.

There is no fixed API-enforced historical lookback window for this endpoint. You can page through all retained Nooks SEP call records available in the workspace. Historical availability depends on when the workspace started using Nooks SEP and the workspace's retained call data. Use filter[time] to fetch by when the call occurred, or filter[createdAt] / filter[updatedAt] for ingestion and sync workflows.

filter[owner][id] is the user who placed the call.

get/calls

Request

  • Base URL: https://partner-api.nooks.in/v1
  • URL: https://partner-api.nooks.in/v1/calls
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://oauth.nooks.in/oauth/authorize, token URL https://oauth.nooks.in/oauth/token, scopes: calls:read)

Query parameters

page[size]integer

Number of items per page (max 100)

page[after]string

Cursor for fetching the next page. Opaque token returned by the API in links.next; callers should treat it as opaque and only pass values they received from a previous response. Malformed cursors return 400 Bad Request.

page[before]string

Cursor for fetching the previous page. Opaque token returned by the API in links.prev; callers should treat it as opaque and only pass values they received from a previous response. Malformed cursors return 400 Bad Request.

filter[id]string

Filter by IDs (comma-separated UUIDs). An empty value is treated as "no filter".

filter[updatedAt][gte]string date-time

Filter by minimum updatedAt (ISO 8601 datetime)

filter[updatedAt][lt]string date-time

Filter by updatedAt before this timestamp, exclusive (ISO 8601 datetime)

filter[time][gte]string date-time

Filter calls that occurred at or after this timestamp (ISO 8601). time is the actual call time (distinct from createdAt, which is the ingestion time).

filter[time][lte]string date-time

Filter calls that occurred at or before this timestamp (ISO 8601).

filter[createdAt][gte]string date-time

Filter calls ingested at or after this timestamp (ISO 8601).

filter[createdAt][lte]string date-time

Filter calls ingested at or before this timestamp (ISO 8601).

filter[prospect][id]string uuid

Filter calls to a specific prospect.

filter[account][id]string uuid

Filter calls associated with a specific account. Matches the account snapshot stored on the call at ingestion time.

filter[callDisposition][id]string uuid

Filter calls by their recorded disposition.

filter[owner][id]string

Filter calls placed by a specific user. Matched via the linked caller's userId (the User who owns the caller record).

includestring[]

Comma-separated relations to expand inline. Valid values: prospect, sequence, sequenceStep, callDisposition, owner. Max 3.

Response

Successful response

Example response

{
  "data": [
    {
      "id": "ff0e8400-e29b-41d4-a716-446655440060",
      "source": "nooks",
      "duration": 120.5,
      "from": "+14155551234",
      "to": "+14155555678",
      "direction": "outgoing",
      "recordingUrl": "https://example.com/recordings/abc123",
      "time": "2025-11-01T09:57:12.000Z",
      "prospect": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "_href": "/v1/sequences/550e8400-e29b-41d4-a716-446655440000"
      },
      "sequence": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "_href": "/v1/sequences/550e8400-e29b-41d4-a716-446655440000"
      },
      "sequenceStep": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "_href": "/v1/sequences/550e8400-e29b-41d4-a716-446655440000"
      },
      "callDisposition": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "_href": "/v1/sequences/550e8400-e29b-41d4-a716-446655440000"
      },
      "owner": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "_href": "/v1/sequences/550e8400-e29b-41d4-a716-446655440000"
      },
      "createdAt": "2025-11-01T10:00:00.000Z",
      "updatedAt": "2025-11-05T14:30:00.000Z"
    }
  ],
  "links": {
    "first": "/v1/sequences?page[size]=50",
    "next": "/v1/sequences?page[size]=50&page[after]=eyJpZCI6IjU1MGU4NDAwLWUyOWItNDFkNC1hNzE2LTQ0NjY1NTQ0MDAwMCIsInYiOjF9"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.