Get DIDs

Returns a list of DIDs owned by your account.

Request

HTTP Method: GET

URI Path: /v3/dids

Note

For all returned data attributes, see Did Object.

URI Query Parameters

Name	Type	Is Required?	Description
include	string	No	Inclusion
filter[<filter_name>]	string, boolean	No	Filtering
fields[dids]	string	No	Sparse fieldsets
sort	string	No	Sorting

Includes

Value	Description
order	Order Object
voice_in_trunk	Trunk Object
voice_in_trunk.voice_in_trunk_group	Trunk Group Object
voice_in_trunk.pop	POP Object
voice_in_trunk_group	Trunk Group Object
capacity_pool	Capacity Pool Object
shared_capacity_group	Shared Capacity Group Object
did_group	DID Group Object
identity	Identity Object
emergency_calling_service	Emergency Calling Service Object
emergency_verification	Emergency Verification Object
did_group.country	Country Object
did_group.city	City Object
did_group.region	Region Object
did_group.did_group_type	DID Group Type Object
did_group.stock_keeping_units	Stock Keeping Unit Object

Filters

Filter Name	Type	Allow Blank	Allow Array	Filters by:
number	string	Yes	Yes	The DID number field.
description	string	Yes	Yes	The description field.
terminated	boolean	No	No	The terminated field.
awaiting_registration	boolean	No	No	The awaiting_registration field.
pending_removal	boolean	No	No	The pending_removal field.
blocked	boolean	No	No	The blocked field.
billing_cycles_count	integer	Yes	No	The billing_cycles_count field.
did_group.id	string	Yes	Yes	The ID field of did_group relationship.
country.id	string	Yes	Yes	The ID field of country relationship.
region.id	string	Yes	Yes	The ID field of region relationship.
city.id	string	Yes	Yes	The ID field of city relationship.
order.id	string	Yes	Yes	The ID field of order relationship.
voice_in_trunk.id	string	Yes	Yes	The ID field of voice_in_trunk relationship.
voice_in_trunk_group.id	string	Yes	Yes	The ID field of voice_in_trunk_group relationship.
shared_capacity_group.id	string	Yes	Yes	The ID field of shared_capacity_group relationship.
capacity_pool.id	string	Yes	Yes	The ID field of capacity_pool relationship.
order.reference	string	No	Yes	The reference field of order relationship.
did_group.features	string	No	Yes	DID Group features field. Can be one or several of voice_in, voice_out, t38, sms_in, p2p, a2p, emergency, and cnam_out. Example: voice_in,emergency.
address_verification.id	string	Yes	Yes	The ID field of address_verification relationship.
emergency_enabled	boolean	No	No	Filters by the emergency_enabled field. Returns DIDs that have emergency calling enabled when true, or disabled when false.
emergency_calling_service.id	string	Yes	Yes	The ID field of emergency_calling_service relationship.

Sorting

Value	Sorts by:
blocked	Blocked status
awaiting_registration	Awaiting registration status
terminated	Termination status
capacity_limit	Capacity limit
billing_cycles_count	Billing cycles count
description	Description text
number	DID number
expires_at	Expiration timestamp
channels_included_count	Included channels count
dedicated_channels_count	Dedicated channels count
created_at	Creation timestamp
emergency_enabled	Emergency calling enabled status

Examples

Simple RequestRequest with did_group IncludeRequest with emergency_calling_service IncludeRequest with identity Include

http

GET /v3/dids HTTP/1.1
Host: api.didww.com
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json
Api-Key: [API token]

curl

curl -i -X GET https://api.didww.com/v3/dids -H "Accept: application/vnd.api+json" -H "Api-Key: [API token]" -H "Content-Type: application/vnd.api+json"

response

HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

  {
    "data": [
      {
        "id": "ac40fb08-ac14-4a6c-8f20-fe650870c266",
        "type": "dids",
        "attributes": {
          "blocked": false,
          "capacity_limit": 1,
          "description": "string",
          "terminated": false,
          "awaiting_registration": false,
          "number": "437xxxxxxxxx",
          "expires_at": "2017-06-25T08:21:41.795Z",
          "channels_included_count": 2,
          "created_at": "2017-06-25T08:21:41.795Z",
          "pending_removal": false,
          "dedicated_channels_count": 0,
          "emergency_enabled": false
        },
        "relationships": {
          "did_group": {
            "links": {
              "self": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/relationships/did_group",
              "related": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/did_group"
            }
          },
          "order": {
            "links": {
              "self": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/relationships/order",
              "related": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/order"
            }
          },
          "voice_in_trunk": {
            "links": {
              "self": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/relationships/voice_in_trunk",
              "related": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/voice_in_trunk"
            }
          },
          "voice_in_trunk_group": {
            "links": {
              "self": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/relationships/voice_in_trunk_group",
              "related": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/voice_in_trunk_group"
            }
          },
          "capacity_pool": {
            "links": {
              "self": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/relationships/capacity_pool",
              "related": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/capacity_pool"
            }
          },
          "shared_capacity_group": {
            "links": {
              "self": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/relationships/shared_capacity_group",
              "related": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/shared_capacity_group"
            }
          },
          "address_verification": {
            "links": {
              "self": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/relationships/address_verification",
              "related": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/address_verification"
            }
          },
          "emergency_calling_service": {
            "links": {
              "self": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/relationships/emergency_calling_service",
              "related": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/emergency_calling_service"
            }
          },
          "emergency_verification": {
            "links": {
              "self": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/relationships/emergency_verification",
              "related": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/emergency_verification"
            }
          },
          "identity": {
            "links": {
              "self": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/relationships/identity",
              "related": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/identity"
            }
          }
        }
      },
      {
        "id": "b37f0fcf-24d0-4799-8e81-a69bcc889f2e",
        "type": "dids",
        "attributes": {
          "blocked": false,
          "capacity_limit": 1,
          "description": "string",
          "terminated": false,
          "awaiting_registration": false,
          "number": "437xxxxxxxxx",
          "expires_at": "2017-06-25T08:21:41.795Z",
          "channels_included_count": 2,
          "created_at": "2017-06-25T08:21:41.795Z",
          "pending_removal": false,
          "dedicated_channels_count": 0,
          "emergency_enabled": false
        },
        "relationships": {
          "did_group": {
            "links": {
              "self": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/relationships/did_group",
              "related": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/did_group"
            }
          },
          "order": {
            "links": {
              "self": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/relationships/order",
              "related": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/order"
            }
          },
          "voice_in_trunk": {
            "links": {
              "self": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/relationships/voice_in_trunk",
              "related": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/voice_in_trunk"
            }
          },
          "voice_in_trunk_group": {
            "links": {
              "self": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/relationships/voice_in_trunk_group",
              "related": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/voice_in_trunk_group"
            }
          },
          "capacity_pool": {
            "links": {
              "self": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/relationships/capacity_pool",
              "related": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/capacity_pool"
            }
          },
          "shared_capacity_group": {
            "links": {
              "self": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/relationships/shared_capacity_group",
              "related": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/shared_capacity_group"
            }
          },
          "address_verification": {
            "links": {
              "self": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/relationships/address_verification",
              "related": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/address_verification"
            }
          },
          "emergency_calling_service": {
            "links": {
              "self": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/relationships/emergency_calling_service",
              "related": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/emergency_calling_service"
            }
          },
          "emergency_verification": {
            "links": {
              "self": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/relationships/emergency_verification",
              "related": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/emergency_verification"
            }
          },
          "identity": {
            "links": {
              "self": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/relationships/identity",
              "related": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/identity"
            }
          }
        }
      }
    ],
    "meta": {
      "total_records": 2,
      "api_version": "2026-04-16"
    },
    "links": {
      "first": "https://api.didww.com/v3/dids?page%5Bnumber%5D=1&page%5Bsize%5D=50",
      "last": "https://api.didww.com/v3/dids?page%5Bnumber%5D=1&page%5Bsize%5D=50"
    }
  }

Other Responses

Code	Success	Description
401	No	Unauthorized