---
title: "List voice logs"
method: GET
path: "/api/voice/logs"
tags: ["Voice Logs"]
---

# List voice logs

`GET /api/voice/logs`

List the available logs.

#### Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_.

[Learn more about API scopes](/docs/platform/your-signalwire-api-space).

## Query parameters

- `include_deleted` boolean
- `created_before` string
- `created_on` string
- `created_after` string
- `page_number` integer
- `page_size` integer
- `page_token` string

## Response `200`

The request has succeeded.

- VoiceLogListResponse — Response model for voice log list endpoint
  - `links` VoiceLogPaginationResponse, required — Pagination links for voice log list responses
    - `self` string, required — URL of the current page.
    - `first` string, required — URL of the first page.
    - `next` string — URL of the next page. Absent on the last page.
    - `prev` string — URL of the previous page. Absent on the first page.
  - `data` VoiceVoiceLog[], required — Array of voice log entries
    - union — A voice log entry. The specific fields present depend on the `type` value. Discarded logs return only `id`, `discarded_at`, and `created_at`.
      - VoiceRelayVoiceLog — Voice log for Compatibility and Relay call types. Returned when `type` is `laml_call`, `relay_pstn_call`, `relay_sip_call`, or `relay_webrtc_call`.
        - `id` string, uuid, required — Universal Unique Identifier.
        - `from` string, required — The origin phone number.
        - `to` string, required — The destination phone number.
        - `source` 'dialogflow' | 'laml' | 'realtime_api', required
        - `charge` number, double, required — The charge in dollars.
        - `charge_details` VoiceChargeDetail[], required — Details on charges associated with this log.
          - `description` string, required — Description for this charge.
          - `charge` number, double, required — Charged amount.
        - `created_at` string, date-time, required — Date and time when the call entry was created.
        - `type` 'laml_call' | 'relay_pstn_call' | 'relay_sip_call' | 'relay_webrtc_call', required
        - `url` string, uri, nullable, required — URL for the resource associated with this log entry. Present for LAML calls, null for Relay calls.
        - `direction` 'inbound' | 'outbound' | 'outbound-api' | 'outbound-dial', required
        - `status` 'queued' | 'initiated' | 'ringing' | 'in-progress' | 'busy' | 'failed' | 'no-answer' | 'canceled' | 'completed' | 'ended' | 'answered' | 'created' | 'ending' | 'joined', required
        - `duration` integer, nullable, required — The duration of the voice activity in seconds.
        - `duration_ms` integer, nullable, required — The duration of the voice activity in milliseconds.
        - `billing_ms` integer, nullable, required — The billable duration of the voice activity in milliseconds.
        - `parent_id` string, nullable, required — Parent log identifier for related call entries.
      - VoiceVideoRoomVoiceLog — Voice log for audio legs in a Video Room. Returned when `type` is `video_room_pstn_leg` or `video_room_sip_leg`.
        - `id` string, uuid, required — Universal Unique Identifier.
        - `from` string, required — The origin phone number.
        - `to` string, required — The destination phone number.
        - `source` 'dialogflow' | 'laml' | 'realtime_api', required
        - `charge` number, double, required — The charge in dollars.
        - `charge_details` VoiceChargeDetail[], required — Details on charges associated with this log.
          - `description` string, required — Description for this charge.
          - `charge` number, double, required — Charged amount.
        - `created_at` string, date-time, required — Date and time when the call entry was created.
        - `type` 'video_room_pstn_leg' | 'video_room_sip_leg', required
        - `url` unknown, required
        - `direction` 'inbound' | 'outbound' | 'outbound-api' | 'outbound-dial', required
        - `status` 'queued' | 'initiated' | 'ringing' | 'in-progress' | 'busy' | 'failed' | 'no-answer' | 'canceled' | 'completed' | 'ended' | 'answered' | 'created' | 'ending' | 'joined', required
        - `duration` integer, nullable, required — The duration of the voice activity in seconds.
        - `duration_ms` integer, nullable, required — The duration of the voice activity in milliseconds.
      - VoiceDialogflowVoiceLog — Voice log for Dialogflow call types. Returned when `type` is `dialogflow_call`.
        - `id` string, uuid, required — Universal Unique Identifier.
        - `from` string, required — The origin phone number.
        - `to` string, required — The destination phone number.
        - `source` 'dialogflow' | 'laml' | 'realtime_api', required
        - `charge` number, double, required — The charge in dollars.
        - `charge_details` VoiceChargeDetail[], required — Details on charges associated with this log.
          - `description` string, required — Description for this charge.
          - `charge` number, double, required — Charged amount.
        - `created_at` string, date-time, required — Date and time when the call entry was created.
        - `type` 'dialogflow_call', required — Type of this log entry.
        - `url` unknown, required
        - `status` 'queued' | 'initiated' | 'ringing' | 'in-progress' | 'busy' | 'failed' | 'no-answer' | 'canceled' | 'completed' | 'ended' | 'answered' | 'created' | 'ending' | 'joined', required
        - `duration` integer, nullable, required — The duration of the voice activity in seconds.
      - VoiceFabricVoiceLog — Voice log for Fabric Subscriber Device call types. Returned when `type` is `fabric_subscriber_device_leg`.
        - `id` string, uuid, required — Universal Unique Identifier.
        - `from` string, required — The origin phone number.
        - `to` string, required — The destination phone number.
        - `source` 'dialogflow' | 'laml' | 'realtime_api', required
        - `charge` number, double, required — The charge in dollars.
        - `charge_details` VoiceChargeDetail[], required — Details on charges associated with this log.
          - `description` string, required — Description for this charge.
          - `charge` number, double, required — Charged amount.
        - `created_at` string, date-time, required — Date and time when the call entry was created.
        - `type` 'fabric_subscriber_device_leg', required — Type of this log entry.
        - `url` unknown, required
        - `direction` 'inbound' | 'outbound' | 'outbound-api' | 'outbound-dial', required
        - `status` 'queued' | 'initiated' | 'ringing' | 'in-progress' | 'busy' | 'failed' | 'no-answer' | 'canceled' | 'completed' | 'ended' | 'answered' | 'created' | 'ending' | 'joined', required
      - VoiceDiscardedVoiceLog — A discarded/deleted voice log entry. Returned when the log has been deleted. Only present when `include_deleted` is `true`.
        - `id` string, uuid, required — Universal Unique Identifier.
        - `discarded_at` string, date-time, required — Date and time when the log was discarded.
        - `created_at` string, date-time, required — Date and time when the log was originally created.

## Other responses

- `400` — The request is invalid.
- `401` — Access is unauthorized.
- `422` — The request contains invalid parameters. See errors for details.
- `500` — An internal server error occurred.

---

[API](https://skmtc.net/signalwire/apis/signalwire-rest-api.md) · [All operations](https://skmtc.net/signalwire/apis/signalwire-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/signalwire/signalwire-rest-api/versions/05c5164b85c7/schema)