# 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](did-object.html).

### URI Query Parameters

| Name | Type | Is Required? | Description |
| --- | --- | --- | --- |
| include | `string` | No | [Inclusion](../../../specification/includes.html#api-includes) |
| filter[<filter\_name>] | `string`, `boolean` | No | [Filtering](../../../specification/filtering.html#api-filters) |
| fields[dids] | `string` | No | [Sparse fieldsets](../../../specification/sparse-fieldsets.html#api-sparse-fieldsets) |
| sort | `string` | No | [Sorting](../../../specification/sorting.html#api-sorting) |

### 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) |

### 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

Simple RequestRequest with did\_group IncludeRequest with emergency\_calling\_service IncludeRequest with identity
Include

[[DIDWW-API-EXAMPLE-START]]

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",
          "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",
          "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"
    }
  }
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
GET /v3/dids?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?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": {
    "total_records": 1,
    "api_version": "2026-04-16"
  },
  "links": {
    "first": "https://api.didww.com/v3/dids?include=did_group&page%5Bnumber%5D=1&page%5Bsize%5D=50",
    "last": "https://api.didww.com/v3/dids?include=did_group&page%5Bnumber%5D=1&page%5Bsize%5D=50"
  }
}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
GET /v3/dids?include=emergency_calling_service 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?include=emergency_calling_service' -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",
        "dedicated_channels_count": 0,
        "emergency_enabled": true
      },
      "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"
          },
          "data": {
            "type": "emergency_calling_services",
            "id": "7f3a1b2c-4d5e-6f7a-8b9c-0d1e2f3a4b5c"
          }
        },
        "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"
          }
        }
      }
    }
  ],
  "included": [
    {
      "id": "7f3a1b2c-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
      "type": "emergency_calling_services",
      "links": {
        "self": "https://api.didww.com/v3/emergency_calling_services/7f3a1b2c-4d5e-6f7a-8b9c-0d1e2f3a4b5c"
      }
    }
  ],
  "meta": {
    "total_records": 1,
    "api_version": "2026-04-16"
  },
  "links": {
    "first": "https://api.didww.com/v3/dids?include=emergency_calling_service&page%5Bnumber%5D=1&page%5Bsize%5D=50",
    "last": "https://api.didww.com/v3/dids?include=emergency_calling_service&page%5Bnumber%5D=1&page%5Bsize%5D=50"
  }
}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
GET /v3/dids?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?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": "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",
        "dedicated_channels_count": 0,
        "emergency_enabled": false
      },
      "relationships": {
        "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"
          },
          "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": {
    "total_records": 1,
    "api_version": "2026-04-16"
  },
  "links": {
    "first": "https://api.didww.com/v3/dids?include=identity&page%5Bnumber%5D=1&page%5Bsize%5D=50",
    "last": "https://api.didww.com/v3/dids?include=identity&page%5Bnumber%5D=1&page%5Bsize%5D=50"
  }
}
```

[[DIDWW-API-EXAMPLE-END]]

## Other Responses

| Code | Success | Description |
| --- | --- | --- |
| 401 | No | [Unauthorized](../../../configuration.html#api-key) |

On this page