---
title: "List destinations"
method: GET
path: "/api/v1/purchases/{purchase_id}/destinations"
tags: ["Inbound Destinations"]
---

# List destinations

`GET /api/v1/purchases/{purchase_id}/destinations`

## Request

- Base URL: `https://app.didlogic.com`
- URL: `https://app.didlogic.com/api/v1/purchases/{purchase_id}/destinations`
- Auth: HTTP bearer

Retrieve the list of inbound destinations configured for a specific DID number.

**Destinations** define where incoming calls to a DID should be routed (SIP addresses, phone numbers, etc.).

**Features:**
- Returns only current (non-deleted) destinations
- Each destination includes active status and its dialing mode (`dialing_type`, with the legacy `callhunt` mirror)

`destination[].id` feeds purchases_destinations_update and purchases_destinations_destroy as `id`.

## Path parameters

- `purchase_id` string, required

## Response `200`

Successfully returns all current destinations for the specified DID

- object
  - `destination` object[], required: List of destinations
    - `id` integer, required: Destination ID
    - `transport` 1 | 4 | 5 | 10 | 12 | 13, required: Transport type: 1 = SIP URI, 4 = Phone number, 5 = SIP device, 10 = Webphone, 12 = WebSocket, 13 = SDK (rings the account of one of your SDK tokens; set up through the SDK, not through this API)
    - `destination` string, required: Forwarding target
    - `priority` integer, required: Destination priority
    - `callhunt` boolean, required: Whether callhunt is enabled
    - `dialing_type` 'sequence' | 'ring_all' | 'random', required: Dialing mode of the group this destination belongs to: `sequence` tries it alone, `ring_all` dials the whole group at once, `random` picks group members in a random order. Mirrors `callhunt` (`ring_all` maps to true).
    - `active` boolean, required: Whether destination is active
    - `ai_agent_id` integer, nullable, required: Linked AI agent ID (null when the destination is not an AI agent)
    - `ai_agent_name` string, nullable, required: Linked AI agent name (null when the destination is not an AI agent)

## Other responses

- `403`: Returns 403 error when API token is incorrect
- `404`: Returns the 404 error envelope {"errors":{"base":["data not found"]}} when neither the DID phone number nor its inventory id matches a DID you own.

---

[API](https://skmtc.dev/didlogic/apis/get-started.md) · [All operations](https://skmtc.dev/didlogic/apis/get-started/llms.txt) · [OpenAPI document](https://skmtc.dev/didlogic/apis/get-started/revisions/dc972d592b34?raw)