List DIDs

Retrieve a list of all configured incoming phone numbers (DIDs) associated with voice agents.

<div class="endpoint-path">
  <span class="badge badge-get">GET</span>
  <code>/v1/dids</code>
</div>

<h2>Authorizations</h2>
<div class="param-row">
  <div class="param-name">X-API-Key</div>
  <div class="param-badges">
    <span class="badge-type">string</span>
    <span class="badge-loc">header</span>
    <span class="badge-req">required</span>
  </div>
  <div class="param-desc">Voice Platform authentication secret token key.</div>
</div>

<h2>Response</h2>
<span class="response-status-info">200 - application/json</span>

<div class="param-row">
  <div class="param-name">id</div>
  <div class="param-badges">
    <span class="badge-type">string</span>
    <span class="badge-req">required</span>
  </div>
  <div class="param-desc">Unique identifier of the DID link.</div>
</div>

<div class="param-row">
  <div class="param-name">didNumber</div>
  <div class="param-badges">
    <span class="badge-type">string</span>
    <span class="badge-req">required</span>
  </div>
  <div class="param-desc">E.164 formatted incoming telephone number.</div>
</div>

curl --request GET \
  --url https://api.branofy.cloud/v1/dids \
  --header 'X-API-Key: your_voice_api_secret_key'

<div class="response-preview">
  <div class="response-header">
    <span>Response</span>
    <span class="status-200">200 OK</span>
  </div>

{
  "data": [
    {
      "id": "did_4455",
      "didNumber": "+15551234567",
      "provider": "voicelink",
      "isDefault": true,
      "updatedAt": "2026-06-21T10:00:00Z"
    }
  ]
}

</div>