# Get DID Returns a single DID owned by your account. ## Request HTTP Method: `GET` URI Path: `/v3/dids/{id}` Note For all returned data attributes, see [Did Object](did-object.html). ### URI Query Parameters | Name | Type | Is Required? | Description | | --- | --- | --- | --- | | id | `string` | Yes | Unique ID identifier of the DID. | | include | `string` | No | Related resources to include in the response. See [Inclusion](../../../specification/includes.html#api-includes). | ### Includes | Value | Description | | --- | --- | | order | [Order Object](../order/order-object.html#order-object-v34) | | voice\_in\_trunk | [Trunk Object](../voice-in-trunks/voice-in-trunk-object.html#voice-in-trunk-object-v34) | | voice\_in\_trunk.voice\_in\_trunk\_group | [Trunk Group Object](../voice-in-trunk-groups/trunk-group-object.html#voice-in-trunk-group-object-v34) | | voice\_in\_trunk.pop | [POP Object](../voice-in-trunks/pop-object.html#pop-object-v34) | | voice\_in\_trunk\_group | [Trunk Group Object](../voice-in-trunk-groups/trunk-group-object.html#voice-in-trunk-group-object-v34) | | capacity\_pool | [Capacity Pool Object](../capacity-pool/capacity-pool-object.html#capacity-pool-object-v34) | | shared\_capacity\_group | [Shared Capacity Group Object](../shared-capacity-group/shared-capacity-group-object.html#shared-capacity-group-object-v34) | | did\_group | [DID Group Object](../../coverage-resources/did-group/did-group-object.html#did-group-object-v34) | | identity | [Identity Object](../../regulation-resources/identities/identity-object.html#identity-object-v34) | | emergency\_calling\_service | [Emergency Calling Service Object](../../emergency-resources/emergency-calling-services/emergency-calling-service-object.html#emergency-calling-service-object-v34) | | emergency\_verification | [Emergency Verification Object](../../emergency-resources/emergency-verifications/emergency-verification-object.html#emergency-verification-object-v34) | | did\_group.country | [Country Object](../../coverage-resources/countries/country-object.html#country-object-v34) | | did\_group.city | [City Object](../../coverage-resources/city/city-object.html#city-object-v34) | | did\_group.region | [Region Object](../../coverage-resources/regions/region-object.html#region-object-v34) | | did\_group.did\_group\_type | [DID Group Type Object](../../coverage-resources/did-group-type/did-group-type-object.html#did-group-type-object-v34) | | did\_group.stock\_keeping\_units | [Stock Keeping Unit Object](../../common-definitions/index.html#stock-keeping-unit-object-v34) | ### Object Relationships | Value | Description | | --- | --- | | order | [Order Object](../order/order-object.html#order-object-v34) | | voice\_in\_trunk | [Trunk Object](../voice-in-trunks/voice-in-trunk-object.html#voice-in-trunk-object-v34) | | voice\_in\_trunk.voice\_in\_trunk\_group | [Trunk Group Object](../voice-in-trunk-groups/trunk-group-object.html#voice-in-trunk-group-object-v34) | | voice\_in\_trunk.pop | [POP Object](../voice-in-trunks/pop-object.html#pop-object-v34) | | voice\_in\_trunk\_group | [Trunk Group Object](../voice-in-trunk-groups/trunk-group-object.html#voice-in-trunk-group-object-v34) | | capacity\_pool | [Capacity Pool Object](../capacity-pool/capacity-pool-object.html#capacity-pool-object-v34) | | shared\_capacity\_group | [Shared Capacity Group Object](../shared-capacity-group/shared-capacity-group-object.html#shared-capacity-group-object-v34) | | did\_group | [DID Group Object](../../coverage-resources/did-group/did-group-object.html#did-group-object-v34) | | identity | [Identity Object](../../regulation-resources/identities/identity-object.html#identity-object-v34) | | emergency\_calling\_service | Emergency Calling Service resource | | emergency\_verification | Emergency Verification resource | | did\_group.country | [Country Object](../../coverage-resources/countries/country-object.html#country-object-v34) | | did\_group.city | [City Object](../../coverage-resources/city/city-object.html#city-object-v34) | | did\_group.region | [Region Object](../../coverage-resources/regions/region-object.html#region-object-v34) | | did\_group.did\_group\_type | [DID Group Type Object](../../coverage-resources/did-group-type/did-group-type-object.html#did-group-type-object-v34) | | did\_group.stock\_keeping\_units | [Stock Keeping Unit Object](../../common-definitions/index.html#stock-keeping-unit-object-v34) | ## Examples Simple RequestRequest with did\_group IncludeRequest with identity Include [[DIDWW-API-EXAMPLE-START]] http ``` GET /v3/dids/44957076-778a-4802-b60c-d22db0cda284 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/44957076-778a-4802-b60c-d22db0cda284 -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": "44957076-778a-4802-b60c-d22db0cda284", "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", "dedicated_channels_count": 0, "emergency_enabled": false }, "relationships": { "did_group": { "links": { "self": "https://api.didww.com/v3/dids/44957076-778a-4802-b60c-d22db0cda284/relationships/did_group", "related": "https://api.didww.com/v3/dids/44957076-778a-4802-b60c-d22db0cda284/did_group" } }, "order": { "links": { "self": "https://api.didww.com/v3/dids/44957076-778a-4802-b60c-d22db0cda284/relationships/order", "related": "https://api.didww.com/v3/dids/44957076-778a-4802-b60c-d22db0cda284/order" } }, "voice_in_trunk": { "links": { "self": "https://api.didww.com/v3/dids/44957076-778a-4802-b60c-d22db0cda284/relationships/voice_in_trunk", "related": "https://api.didww.com/v3/dids/44957076-778a-4802-b60c-d22db0cda284/voice_in_trunk" } }, "voice_in_trunk_group": { "links": { "self": "https://api.didww.com/v3/dids/44957076-778a-4802-b60c-d22db0cda284/relationships/voice_in_trunk_group", "related": "https://api.didww.com/v3/dids/44957076-778a-4802-b60c-d22db0cda284/voice_in_trunk_group" } }, "capacity_pool": { "links": { "self": "https://api.didww.com/v3/dids/44957076-778a-4802-b60c-d22db0cda284/relationships/capacity_pool", "related": "https://api.didww.com/v3/dids/44957076-778a-4802-b60c-d22db0cda284/capacity_pool" } }, "shared_capacity_group": { "links": { "self": "https://api.didww.com/v3/dids/44957076-778a-4802-b60c-d22db0cda284/relationships/shared_capacity_group", "related": "https://api.didww.com/v3/dids/44957076-778a-4802-b60c-d22db0cda284/shared_capacity_group" } }, "address_verification": { "links": { "self": "https://api.didww.com/v3/dids/44957076-778a-4802-b60c-d22db0cda284/relationships/address_verification", "related": "https://api.didww.com/v3/dids/44957076-778a-4802-b60c-d22db0cda284/address_verification" } }, "emergency_calling_service": { "links": { "self": "https://api.didww.com/v3/dids/44957076-778a-4802-b60c-d22db0cda284/relationships/emergency_calling_service", "related": "https://api.didww.com/v3/dids/44957076-778a-4802-b60c-d22db0cda284/emergency_calling_service" } }, "emergency_verification": { "links": { "self": "https://api.didww.com/v3/dids/44957076-778a-4802-b60c-d22db0cda284/relationships/emergency_verification", "related": "https://api.didww.com/v3/dids/44957076-778a-4802-b60c-d22db0cda284/emergency_verification" } }, "identity": { "links": { "self": "https://api.didww.com/v3/dids/44957076-778a-4802-b60c-d22db0cda284/relationships/identity", "related": "https://api.didww.com/v3/dids/44957076-778a-4802-b60c-d22db0cda284/identity" } } } }, "meta": { "api_version": "2026-04-16" } } ``` [[DIDWW-API-EXAMPLE-END]] [[DIDWW-API-EXAMPLE-START]] http ``` GET /v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d?include=did_group 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/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d?include=did_group' -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": "2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d", "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", "dedicated_channels_count": 0, "emergency_enabled": false }, "relationships": { "did_group": { "links": { "self": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/relationships/did_group", "related": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/did_group" }, "data": { "type": "did_groups", "id": "d04b6466-3d98-4be1-aac5-93ee241f57ca" } }, "order": { "links": { "self": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/relationships/order", "related": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/order" } }, "voice_in_trunk": { "links": { "self": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/relationships/voice_in_trunk", "related": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/voice_in_trunk" } }, "voice_in_trunk_group": { "links": { "self": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/relationships/voice_in_trunk_group", "related": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/voice_in_trunk_group" } }, "capacity_pool": { "links": { "self": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/relationships/capacity_pool", "related": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/capacity_pool" } }, "shared_capacity_group": { "links": { "self": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/relationships/shared_capacity_group", "related": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/shared_capacity_group" } }, "address_verification": { "links": { "self": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/relationships/address_verification", "related": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/address_verification" } }, "emergency_calling_service": { "links": { "self": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/relationships/emergency_calling_service", "related": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/emergency_calling_service" } }, "emergency_verification": { "links": { "self": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/relationships/emergency_verification", "related": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/emergency_verification" } }, "identity": { "links": { "self": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/relationships/identity", "related": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/identity" } } } }, "included": [ { "id": "d04b6466-3d98-4be1-aac5-93ee241f57ca", "type": "did_groups", "links": { "self": "https://api.didww.com/v3/did_groups/d04b6466-3d98-4be1-aac5-93ee241f57ca" }, "attributes": { "prefix": "721", "local_prefix": "", "features": [ "voice_in" ], "is_metered": false, "area_name": "National", "allow_additional_channels": true } } ], "meta": { "api_version": "2026-04-16" } } ``` [[DIDWW-API-EXAMPLE-END]] [[DIDWW-API-EXAMPLE-START]] http ``` GET /v3/dids/44957076-778a-4802-b60c-d22db0cda284?include=identity 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/44957076-778a-4802-b60c-d22db0cda284?include=identity' -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": "44957076-778a-4802-b60c-d22db0cda284", "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", "dedicated_channels_count": 0, "emergency_enabled": false }, "relationships": { "identity": { "links": { "self": "https://api.didww.com/v3/dids/44957076-778a-4802-b60c-d22db0cda284/relationships/identity", "related": "https://api.didww.com/v3/dids/44957076-778a-4802-b60c-d22db0cda284/identity" }, "data": { "type": "identities", "id": "9f1d6db1-2a8d-4c72-b7d6-8f3b2d7e6b41" } } } }, "included": [ { "id": "9f1d6db1-2a8d-4c72-b7d6-8f3b2d7e6b41", "type": "identities", "links": { "self": "https://api.didww.com/v3/identities/9f1d6db1-2a8d-4c72-b7d6-8f3b2d7e6b41" }, "attributes": { "first_name": "John", "last_name": "Doe", "birth_date": "1985-02-10", "email": "john.doe@example.com" } } ], "meta": { "api_version": "2026-04-16" } } ``` [[DIDWW-API-EXAMPLE-END]] ## Other Responses | Code | Success | Description | | --- | --- | --- | | 404 | No | [Not Found](../../../specification/errors/index.html#api-not-found) | | 401 | No | [Unauthorized](../../../configuration.html#api-key) | On this page