Get Available DIDs#

Returns a list of Available DIDs. Pagination and Sorting are disabled.

Warning

Do not use the number selection tool to populate another database with available numbers, as DID inventory changes frequently.

Note

  • The /v3/available_dids endpoint is disabled by default. Contact Customer Service or Sales to enable it.

  • Results are returned in random order.

  • Requests are not cached. A new request may return the same results as a previous one, depending on the filters applied.

Request#

HTTP Method: GET

URI Path: /v3/available_dids

Note

For all returned data attributes, see Available Did Object.

URI Query Parameters#

Name

Type

Is Required?

Description

include

string

No

Inclusion

filter[<filter_name>]

string, boolean

No

Filtering

fields[available_dids]

string

No

Sparse fieldsets

Includes#

Value

Description

did_group

DID Group Object

did_group.stock_keeping_units

Stock Keeping Unit Object

nanpa_prefix

Nanpa Prefix Object

Filters#

Filter Name

Type

Allow Blank

Allow Array

Filters by:

id

string

No

Yes

Available DID id field.

number_contains

string

No

No

The number field.

did_group.id

string

No

Yes

DID Group id field.

did_group_type.id

string

No

Yes

DID Group type id field.

country.id

string

No

Yes

DID Group country id field.

region.id

string

No

Yes

DID Group region id field.

city.id

string

No

Yes

DID Group city id field.

did_group.needs_registration

boolean

No

No

DID Group needs_registration field.

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.

nanpa_prefix.id

string

No

No

Nanpa prefix id field.

Examples#

http

1GET /v3/available_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/available_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": "55ac507c-6248-412a-abbb-a02bbe7034e6",
  8            "type": "available_dids",
  9            "attributes": {
 10                "number": "12124727600"
 11            },
 12            "relationships": {
 13                "did_group": {
 14                    "links": {
 15                        "self": "https://api.didww.com/v3/available_dids/55ac507c-6248-412a-abbb-a02bbe7034e6/relationships/did_group",
 16                        "related": "https://api.didww.com/v3/available_dids/55ac507c-6248-412a-abbb-a02bbe7034e6/did_group"
 17                    }
 18                },
 19                "nanpa_prefix": {
 20                    "links": {
 21                        "self": "https://api.didww.com/v3/available_dids/55ac507c-6248-412a-abbb-a02bbe7034e6/relationships/nanpa_prefix",
 22                        "related": "https://api.didww.com/v3/available_dids/55ac507c-6248-412a-abbb-a02bbe7034e6/nanpa_prefix"
 23                    }
 24                }
 25            }
 26        },
 27        {
 28            "id": "54563944-801d-40ba-add1-b9e48b669493",
 29            "type": "available_dids",
 30            "attributes": {
 31                "number": "14803023230"
 32            },
 33            "relationships": {
 34                "did_group": {
 35                    "links": {
 36                        "self": "https://api.didww.com/v3/available_dids/54563944-801d-40ba-add1-b9e48b669493/relationships/did_group",
 37                        "related": "https://api.didww.com/v3/available_dids/54563944-801d-40ba-add1-b9e48b669493/did_group"
 38                    }
 39                },
 40                "nanpa_prefix": {
 41                    "links": {
 42                        "self": "https://api.didww.com/v3/available_dids/54563944-801d-40ba-add1-b9e48b669493/relationships/nanpa_prefix",
 43                        "related": "https://api.didww.com/v3/available_dids/54563944-801d-40ba-add1-b9e48b669493/nanpa_prefix"
 44                    }
 45                }
 46            }
 47        },
 48        {
 49            "id": "126607e3-1ff7-4399-89cf-aea426c47134",
 50            "type": "available_dids",
 51            "attributes": {
 52                "number": "14806858120"
 53            },
 54            "relationships": {
 55                "did_group": {
 56                    "links": {
 57                        "self": "https://api.didww.com/v3/available_dids/126607e3-1ff7-4399-89cf-aea426c47134/relationships/did_group",
 58                        "related": "https://api.didww.com/v3/available_dids/126607e3-1ff7-4399-89cf-aea426c47134/did_group"
 59                    }
 60                },
 61                "nanpa_prefix": {
 62                    "links": {
 63                        "self": "https://api.didww.com/v3/available_dids/126607e3-1ff7-4399-89cf-aea426c47134/relationships/nanpa_prefix",
 64                        "related": "https://api.didww.com/v3/available_dids/126607e3-1ff7-4399-89cf-aea426c47134/nanpa_prefix"
 65                    }
 66                }
 67            }
 68        },
 69        {
 70            "id": "90113411-3037-4f25-a33b-7898b601f271",
 71            "type": "available_dids",
 72            "attributes": {
 73                "number": "14806858091"
 74            },
 75            "relationships": {
 76                "did_group": {
 77                    "links": {
 78                        "self": "https://api.didww.com/v3/available_dids/90113411-3037-4f25-a33b-7898b601f271/relationships/did_group",
 79                        "related": "https://api.didww.com/v3/available_dids/90113411-3037-4f25-a33b-7898b601f271/did_group"
 80                    }
 81                },
 82                "nanpa_prefix": {
 83                    "links": {
 84                        "self": "https://api.didww.com/v3/available_dids/90113411-3037-4f25-a33b-7898b601f271/relationships/nanpa_prefix",
 85                        "related": "https://api.didww.com/v3/available_dids/90113411-3037-4f25-a33b-7898b601f271/nanpa_prefix"
 86                    }
 87                }
 88            }
 89        },
 90        {
 91            "id": "a017bb1a-b4b1-48cb-9331-31bf6394f191",
 92            "type": "available_dids",
 93            "attributes": {
 94                "number": "14806858035"
 95            },
 96            "relationships": {
 97                "did_group": {
 98                    "links": {
 99                        "self": "https://api.didww.com/v3/available_dids/a017bb1a-b4b1-48cb-9331-31bf6394f191/relationships/did_group",
100                        "related": "https://api.didww.com/v3/available_dids/a017bb1a-b4b1-48cb-9331-31bf6394f191/did_group"
101                    }
102                },
103                "nanpa_prefix": {
104                    "links": {
105                        "self": "https://api.didww.com/v3/available_dids/a017bb1a-b4b1-48cb-9331-31bf6394f191/relationships/nanpa_prefix",
106                        "related": "https://api.didww.com/v3/available_dids/a017bb1a-b4b1-48cb-9331-31bf6394f191/nanpa_prefix"
107                    }
108                }
109            }
110        },
111        {
112            "id": "44ba95af-4b61-49a8-ae41-6235cc8cb573",
113            "type": "available_dids",
114            "attributes": {
115                "number": "12124727602"
116            },
117            "relationships": {
118                "did_group": {
119                    "links": {
120                        "self": "https://api.didww.com/v3/available_dids/44ba95af-4b61-49a8-ae41-6235cc8cb573/relationships/did_group",
121                        "related": "https://api.didww.com/v3/available_dids/44ba95af-4b61-49a8-ae41-6235cc8cb573/did_group"
122                    }
123                },
124                "nanpa_prefix": {
125                    "links": {
126                        "self": "https://api.didww.com/v3/available_dids/44ba95af-4b61-49a8-ae41-6235cc8cb573/relationships/nanpa_prefix",
127                        "related": "https://api.didww.com/v3/available_dids/44ba95af-4b61-49a8-ae41-6235cc8cb573/nanpa_prefix"
128                    }
129                }
130            }
131        },
132        {
133            "id": "7f396769-5203-470c-9595-b158c6bba7c8",
134            "type": "available_dids",
135            "attributes": {
136                "number": "12124727603"
137            },
138            "relationships": {
139                "did_group": {
140                    "links": {
141                        "self": "https://api.didww.com/v3/available_dids/7f396769-5203-470c-9595-b158c6bba7c8/relationships/did_group",
142                        "related": "https://api.didww.com/v3/available_dids/7f396769-5203-470c-9595-b158c6bba7c8/did_group"
143                    }
144                },
145                "nanpa_prefix": {
146                    "links": {
147                        "self": "https://api.didww.com/v3/available_dids/7f396769-5203-470c-9595-b158c6bba7c8/relationships/nanpa_prefix",
148                        "related": "https://api.didww.com/v3/available_dids/7f396769-5203-470c-9595-b158c6bba7c8/nanpa_prefix"
149                    }
150                }
151            }
152        },
153        {
154            "id": "065fda4b-1730-4e20-81d0-96f7335347ea",
155            "type": "available_dids",
156            "attributes": {
157                "number": "12124727606"
158            },
159            "relationships": {
160                "did_group": {
161                    "links": {
162                        "self": "https://api.didww.com/v3/available_dids/065fda4b-1730-4e20-81d0-96f7335347ea/relationships/did_group",
163                        "related": "https://api.didww.com/v3/available_dids/065fda4b-1730-4e20-81d0-96f7335347ea/did_group"
164                    }
165                },
166                "nanpa_prefix": {
167                    "links": {
168                        "self": "https://api.didww.com/v3/available_dids/065fda4b-1730-4e20-81d0-96f7335347ea/relationships/nanpa_prefix",
169                        "related": "https://api.didww.com/v3/available_dids/065fda4b-1730-4e20-81d0-96f7335347ea/nanpa_prefix"
170                    }
171                }
172            }
173        },
174        {
175            "id": "5dead00e-6751-411a-929b-a25e5bace5b0",
176            "type": "available_dids",
177            "attributes": {
178                "number": "14806858086"
179            },
180            "relationships": {
181                "did_group": {
182                    "links": {
183                        "self": "https://api.didww.com/v3/available_dids/5dead00e-6751-411a-929b-a25e5bace5b0/relationships/did_group",
184                        "related": "https://api.didww.com/v3/available_dids/5dead00e-6751-411a-929b-a25e5bace5b0/did_group"
185                    }
186                },
187                "nanpa_prefix": {
188                    "links": {
189                        "self": "https://api.didww.com/v3/available_dids/5dead00e-6751-411a-929b-a25e5bace5b0/relationships/nanpa_prefix",
190                        "related": "https://api.didww.com/v3/available_dids/5dead00e-6751-411a-929b-a25e5bace5b0/nanpa_prefix"
191                    }
192                }
193            }
194        },
195        {
196            "id": "75a21935-acfd-4160-8485-9fb7d049f144",
197            "type": "available_dids",
198            "attributes": {
199                "number": "12124727604"
200            },
201            "relationships": {
202                "did_group": {
203                    "links": {
204                        "self": "https://api.didww.com/v3/available_dids/75a21935-acfd-4160-8485-9fb7d049f144/relationships/did_group",
205                        "related": "https://api.didww.com/v3/available_dids/75a21935-acfd-4160-8485-9fb7d049f144/did_group"
206                    }
207                },
208                "nanpa_prefix": {
209                    "links": {
210                        "self": "https://api.didww.com/v3/available_dids/75a21935-acfd-4160-8485-9fb7d049f144/relationships/nanpa_prefix",
211                        "related": "https://api.didww.com/v3/available_dids/75a21935-acfd-4160-8485-9fb7d049f144/nanpa_prefix"
212                    }
213                }
214            }
215        }
216    ],
217    "meta": {
218        "total_count": 361188,
219        "api_version": "2026-04-16"
220    }
221}

Response#

Top Level Meta Attributes#

Name

Type

Description

total_count

integer

Total count of available DIDs that match the query.

available_count

integer

Count of available DIDs for reservation.

Other Responses#

Code

Success

Description

401

No

Unauthorized