List destinations

GET 
/api/v1/purchases/:purchase_id/destinations

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)

Authentication:

• Requires Bearer token in Authorization header: Authorization: Bearer <token>

Request

Responses

200

Successfully returns all current destinations for the specified DID

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.