---
title: "Get CDR events"
method: GET
path: "/api/v4/reporting/cdrs/{cdr_id}/events"
tags: ["Reporting"]
---

# Get CDR events

`GET /api/v4/reporting/cdrs/{cdr_id}/events`

## Request

- Base URL: `https://{cluster_id}.voiso.com`
- URL: `https://{cluster_id}.voiso.com/api/v4/reporting/cdrs/{cdr_id}/events`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/voiso/apis/voiso-api/docs/api/v4/reporting/cdrs/:cdr_id/events/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns paginated list of events for a specific CDR.

## Path parameters

- `cdr_id` string, uuid, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

OK

- object
  - `cdr_events` CdrEvent[]
    - `id` string: CDR event identifier.
    - `event` 'prequeue' | 'inqueue' | 'routing' | 'dialing' | 'connected' | 'talk' | 'released' | 'hangup' | 'terminate' | 'hold' | 'callback' | 'agent_connected' | 'queue_callback_request' | 'blind_transfer' | 'transfering' | 'consulting' | 'forward' | 'forward_talk' | 'participant' | 'conference' | 'listen' | 'whisper' | 'join' | 'intercept' | 'voice_mail' | 'voice_mail_announce' | 'postcall' | 'recording_mute' | 'recording_unmute' | 'microphone_mute' | 'timeout' | 'reject' | 'dnd_reject' | 'fail' | 'agent_declined' | 'agent_timed_out' | 'agent_logged_off' | 'open' | 'accept' | 'forward_to_queue' | 'accept_forwarding' | 'archive' | 'disconnect' | 'start_monitoring' | 'stop_monitoring' | 'start_whispering' | 'stop_whispering' | 'start_barging_in' | 'stop_barging_in' | 'business_initiated_wait' | 'force_close': CDR event name.
    - `duration` number, float, nullable: CDR event duration in seconds.
    - `user` object, nullable: Reference metadata captured in the CDR.
      - `id` integer: The unique identifier of the user.
      - `name` string: The name of the user.
      - `email` string, email: The email address of the user.
      - `name_snapshot` string, nullable: Name snapshot captured at the time of the interaction.
      - `deleted` boolean: Whether the referenced record is deleted.
    - `queue` object, nullable: Reference metadata captured in the CDR.
      - `id` integer: The unique identifier of the queue.
      - `name` string: The name of the queue.
      - `name_snapshot` string, nullable: Name snapshot captured at the time of the interaction.
      - `deleted` boolean: Whether the referenced record is deleted.
    - `manager` boolean: Whether the agent acted as a manager.
    - `started_at` string, date-time: When the CDR event started.
    - `ended_at` string, date-time, nullable: When the CDR event ended.
  - `metadata` Metadata: Pagination metadata for list responses.
    - `total` integer: The total number of items available for the requested resource.
    - `next_cursor` string, nullable: Cursor for fetching the next page of results when cursor-based pagination is supported.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found

---

[API](https://skmtc.dev/voiso/apis/voiso-api.md) - [All operations](https://skmtc.dev/voiso/apis/voiso-api/llms.txt) - [OpenAPI document](https://skmtc.dev/voiso/apis/voiso-api/revisions/5a6ea146bd21?raw)