AI

Gets a list of ai summaries.

Changed on

Retrieves a paginated list of ai summaries for the authenticated customer. Optionally filter by the origin resource (reference_type + reference_id) to find all summaries tied to a specific call, conference, transcribe, or recording. Note a single reference can have multiple summaries (e.g. regenerated summaries), so this always returns a list, not a single item.

get/aisummaries

Request

  • Base URL
    https://api.voipbin.net/v1.0
  • URL
    https://api.voipbin.net/v1.0/aisummaries
  • Auth
    none declared

Query parameters

page_sizeinteger
Example:25

Number of results to return per page.

page_tokenstring

Cursor token for pagination. Use the next_page_token value from the previous response.

reference_type'' | 'call' | 'conference' | 'transcribe' | 'recording'

Type of reference for the AI summary.

Example:call

Filter by the reference type of the origin resource. Must be supplied together with reference_id; supplying only one of the two returns a 400 error.

reference_idstring uuid

Filter by the ID of the origin resource (e.g. a recording ID returned from GET /recordings). Must be supplied together with reference_type; supplying only one of the two returns a 400 error.

Response

A list of ai summaries.

next_page_tokenstring

Cursor token for the next page of results. Pass this value as the page_token parameter in the next request.

Example response

{
  "result": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "customer_id": "7c4d2f3a-1b8e-4f5c-9a6d-3e2f1a0b4c5d",
      "activeflow_id": "550e8400-e29b-41d4-a716-446655440000",
      "on_end_flow_id": "550e8400-e29b-41d4-a716-446655440000",
      "reference_type": "call",
      "reference_id": "550e8400-e29b-41d4-a716-446655440000",
      "status": "progressing",
      "language": "en-US",
      "content": "The customer called to inquire about their account balance and was assisted by the support agent.",
      "tm_create": "2026-01-15T09:30:00.000000Z",
      "tm_update": "2026-01-15T09:30:00.000000Z",
      "tm_delete": "2026-01-15T09:30:00.000000Z"
    }
  ]
}

Changes

  • 89740a2650e0Revision changes
    • info

      added the new optional query request parameter reference_id

    • info

      added the new optional query request parameter reference_type

    • info

      added the non-success response with the status