---
title: "List Voice destination countries"
method: GET
path: "/v1/voice/destinations"
tags: ["voice-destinations"]
---

# List Voice destination countries

`GET /v1/voice/destinations`

## Request

- Base URL: `https://us1.platform.bird.com`
- URL: `https://us1.platform.bird.com/v1/voice/destinations`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `bird_session`

Returns every country the Voice service supports, each annotated with whether your workspace has enabled calling to it, whether the platform supports calling it (`status`), and any daily spend limit you set for it with today's usage. A supported, enabled country still refuses calls once its `daily_spend_limit.remaining` reaches zero. Use this to render and manage your destination allowlist.

## Headers

- `X-Workspace-Id` string
- `X-Organization-Id` string

## Response `200`

The Voice destination countries with your workspace's enabled settings.

- VoiceDestinationList
  - `data` VoiceDestination[], required: The Voice destination countries, each annotated with your workspace's enabled setting.
    - `country_code` string, required: ISO 3166-1 alpha-2 country code.
    - `country_name` string, required: Full English country name.
    - `dial_code` string: International dialling prefix, without the leading plus. Absent for countries that have none.
    - `region` string, nullable: The commercial region this country belongs to, for grouping a destination list the way it is bought rather than alphabetically. `null` for a country we have not assigned yet. Bird defines these regions independently of ISO and UN M49. A country can move between them, so treat the set as open.
    - `super_region` string, nullable: The continent-scale group the region rolls up into. Derived from `region`, and `null` whenever that is. Treat the set as open.
    - `enabled` boolean, required: Whether your workspace has enabled calling to this country.
    - `status` string, required: This country's Voice callability at the destination level, independent of your enabled setting. `available` means we place calls there; `not_supported` means we do not.
    - `high_risk_destination` boolean, required: Whether we treat this country as a high-risk calling destination.
    - `daily_spend_limit` VoiceDestinationDailySpendLimit, required
      - `limit` Money, required
        - `amount` string, required: Decimal amount as a string, in major currency units.
        - `currency_code` string, required: ISO 4217 three-letter currency code.
      - `used` Money, required
        - `amount` string, required: Decimal amount as a string, in major currency units.
        - `currency_code` string, required: ISO 4217 three-letter currency code.
      - `remaining` Money, required
        - `amount` string, required: Decimal amount as a string, in major currency units.
        - `currency_code` string, required: ISO 4217 three-letter currency code.
      - `resets_at` string, date-time, required: When usage resets to zero, at midnight UTC.
  - `total` integer, required: Total number of destination countries.

## Other responses

- `400`: Bad request
- `401`: Authentication required
- `403`: Insufficient permissions
- `404`: Resource not found
- `422`: The request has invalid field values, violates a business rule, or carries a query parameter the endpoint does not declare. Field validation errors use `type: validation_error` and include the affected fields in `details`. Business-rule errors identify the failed rule in `type`.
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/messagebird/apis/bird-api.md) · [All operations](https://skmtc.dev/messagebird/apis/bird-api/llms.txt) · [OpenAPI document](https://skmtc.dev/messagebird/apis/bird-api/revisions/6dfce1179799?raw)