Get Available DID#

Returns a single Available DID from DIDWW inventory.

Note

Available DID request is not enabled by default. To enable this feature, please contact our Customer Service or Sales Departments.

Request#

HTTP Method: GET

URI Path: /v3/available_dids/{id}

Note

For all returned data attributes, see Available Did Object.

URI Query Parameters#

Name

Type

Is Required?

Description

id

string

Yes

Unique ID number of the Available DID.

include

string

No

Inclusion

Includes#

Value

Description

did_group

DID Group Object

did_group.stock_keeping_units

Stock Keeping Unit Object

nanpa_prefix

Nanpa Prefix Object

Examples#

http

1GET /v3/available_dids/75a21935-acfd-4160-8485-9fb7d049f144 HTTP/1.1
2Host: api.didww.com
3Content-Type: application/vnd.api+json
4Accept: application/vnd.api+json
5Authorization: Bearer [access token]

curl

1curl -i -X GET https://api.didww.com/v3/available_dids/75a21935-acfd-4160-8485-9fb7d049f144 -H "Accept: application/vnd.api+json" -H "Content-Type: application/vnd.api+json" -H "Authorization: Bearer [access token]"

response

 1HTTP/1.1 200 OK
 2Content-Type: application/vnd.api+json
 3
 4 {
 5     "data": {
 6         "id": "75a21935-acfd-4160-8485-9fb7d049f144",
 7         "type": "available_dids",
 8         "attributes": {
 9             "number": "12124727604"
10         },
11         "relationships": {
12             "did_group": {
13                 "links": {
14                     "self": "https://api.didww.com/v3/available_dids/75a21935-acfd-4160-8485-9fb7d049f144/relationships/did_group",
15                     "related": "https://api.didww.com/v3/available_dids/75a21935-acfd-4160-8485-9fb7d049f144/did_group"
16                 }
17             },
18             "nanpa_prefix": {
19                 "links": {
20                     "self": "https://api.didww.com/v3/available_dids/75a21935-acfd-4160-8485-9fb7d049f144/relationships/nanpa_prefix",
21                     "related": "https://api.didww.com/v3/available_dids/75a21935-acfd-4160-8485-9fb7d049f144/nanpa_prefix"
22                 }
23             }
24         }
25     },
26     "meta": {
27         "api_version": "2026-11-19"
28     }
29 }

Other Responses#

Code

Success

Description

404

No

Not Found

401

No

Unauthorized

403

No

Numbers selection is not enabled for the account.

429

No

The request budget of the account for the current window is spent (too_many_requests). Retry-After gives the number of seconds to wait.