---
title: "List DID numbers"
method: GET
path: "/did_numbers"
tags: ["Portal", "Portal DID-Numbers"]
---

# List DID numbers

`GET /did_numbers`

list the customer's operational DID numbers

## Response `200`

Successful Response

- DIDNumbersResponse — Envelope returned by `GET /portal/did_numbers`.
  - `did_numbers` DIDNumberItem[], required
    - `number` string, required — Phone number in E.164 (no leading "+").
    - `name` string — Human-readable description (typically "Country - City - Type").
    - `state` string — Lifecycle state (e.g. "activated", "pending", "cancelled").
    - `country` string — ISO 3166-1 alpha-2 country code (e.g. "US").
    - `next_billing_date` string — Next monthly billing date (YYYY-MM-DD).
    - `auto_renewal` boolean — Whether the DID auto-renews on the next billing date.
    - `monthly_fee` number — Monthly fee in customer currency.
    - `identity` string — Identity document the DID is registered to.
    - `tags` string[] — Free-form tag names attached to the DID.
    - `sms` boolean — Whether SMS-to-email is enabled for the DID.
    - `did_order` string — Short description of the originating order (order id + creation timestamp).
    - `forward_uri` string — Forwarding SIP URI, if configured.
    - `forward_sip` string — Forwarding SIP account name, if configured.
    - `forward_pstn` string — Forwarding PSTN number, if configured.
    - `forward_order` string — Order in which forward destinations are attempted (e.g. "sip_uri_pstn").

---

[API](https://skmtc.net/commpeak/apis/dialer-api-v2-0-1.md) · [All operations](https://skmtc.net/commpeak/apis/dialer-api-v2-0-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/commpeak/dialer-api-v2-0-1/revisions/eacecf960bb6/schema)