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.

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#

http

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

curl

1curl -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

  1HTTP/1.1 200 OK
  2Content-Type: application/vnd.api+json
  3
  4  {
  5    "data": [
  6      {
  7        "id": "ac40fb08-ac14-4a6c-8f20-fe650870c266",
  8        "type": "dids",
  9        "attributes": {
 10          "blocked": false,
 11          "capacity_limit": 1,
 12          "description": "string",
 13          "terminated": false,
 14          "awaiting_registration": false,
 15          "number": "437xxxxxxxxx",
 16          "expires_at": "2017-06-25T08:21:41.795Z",
 17          "channels_included_count": 2,
 18          "created_at": "2017-06-25T08:21:41.795Z",
 19          "dedicated_channels_count": 0,
 20          "emergency_enabled": false
 21        },
 22        "relationships": {
 23          "did_group": {
 24            "links": {
 25              "self": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/relationships/did_group",
 26              "related": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/did_group"
 27            }
 28          },
 29          "order": {
 30            "links": {
 31              "self": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/relationships/order",
 32              "related": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/order"
 33            }
 34          },
 35          "voice_in_trunk": {
 36            "links": {
 37              "self": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/relationships/voice_in_trunk",
 38              "related": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/voice_in_trunk"
 39            }
 40          },
 41          "voice_in_trunk_group": {
 42            "links": {
 43              "self": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/relationships/voice_in_trunk_group",
 44              "related": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/voice_in_trunk_group"
 45            }
 46          },
 47          "capacity_pool": {
 48            "links": {
 49              "self": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/relationships/capacity_pool",
 50              "related": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/capacity_pool"
 51            }
 52          },
 53          "shared_capacity_group": {
 54            "links": {
 55              "self": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/relationships/shared_capacity_group",
 56              "related": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/shared_capacity_group"
 57            }
 58          },
 59          "address_verification": {
 60            "links": {
 61              "self": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/relationships/address_verification",
 62              "related": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/address_verification"
 63            }
 64          },
 65          "emergency_calling_service": {
 66            "links": {
 67              "self": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/relationships/emergency_calling_service",
 68              "related": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/emergency_calling_service"
 69            }
 70          },
 71          "emergency_verification": {
 72            "links": {
 73              "self": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/relationships/emergency_verification",
 74              "related": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/emergency_verification"
 75            }
 76          },
 77          "identity": {
 78            "links": {
 79              "self": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/relationships/identity",
 80              "related": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/identity"
 81            }
 82          }
 83        }
 84      },
 85      {
 86        "id": "b37f0fcf-24d0-4799-8e81-a69bcc889f2e",
 87        "type": "dids",
 88        "attributes": {
 89          "blocked": false,
 90          "capacity_limit": 1,
 91          "description": "string",
 92          "terminated": false,
 93          "awaiting_registration": false,
 94          "number": "437xxxxxxxxx",
 95          "expires_at": "2017-06-25T08:21:41.795Z",
 96          "channels_included_count": 2,
 97          "created_at": "2017-06-25T08:21:41.795Z",
 98          "dedicated_channels_count": 0,
 99          "emergency_enabled": false
100        },
101        "relationships": {
102          "did_group": {
103            "links": {
104              "self": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/relationships/did_group",
105              "related": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/did_group"
106            }
107          },
108          "order": {
109            "links": {
110              "self": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/relationships/order",
111              "related": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/order"
112            }
113          },
114          "voice_in_trunk": {
115            "links": {
116              "self": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/relationships/voice_in_trunk",
117              "related": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/voice_in_trunk"
118            }
119          },
120          "voice_in_trunk_group": {
121            "links": {
122              "self": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/relationships/voice_in_trunk_group",
123              "related": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/voice_in_trunk_group"
124            }
125          },
126          "capacity_pool": {
127            "links": {
128              "self": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/relationships/capacity_pool",
129              "related": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/capacity_pool"
130            }
131          },
132          "shared_capacity_group": {
133            "links": {
134              "self": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/relationships/shared_capacity_group",
135              "related": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/shared_capacity_group"
136            }
137          },
138          "address_verification": {
139            "links": {
140              "self": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/relationships/address_verification",
141              "related": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/address_verification"
142            }
143          },
144          "emergency_calling_service": {
145            "links": {
146              "self": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/relationships/emergency_calling_service",
147              "related": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/emergency_calling_service"
148            }
149          },
150          "emergency_verification": {
151            "links": {
152              "self": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/relationships/emergency_verification",
153              "related": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/emergency_verification"
154            }
155          },
156          "identity": {
157            "links": {
158              "self": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/relationships/identity",
159              "related": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/identity"
160            }
161          }
162        }
163      }
164    ],
165    "meta": {
166      "total_records": 2,
167      "api_version": "2026-04-16"
168    },
169    "links": {
170      "first": "https://api.didww.com/v3/dids?page%5Bnumber%5D=1&page%5Bsize%5D=50",
171      "last": "https://api.didww.com/v3/dids?page%5Bnumber%5D=1&page%5Bsize%5D=50"
172    }
173  }

Other Responses#

Code

Success

Description

401

No

Unauthorized