Get DIDs

Description

Returns a list of DIDs owned by your account.

Request

HTTP Method: GET

URI Path: /v3/dids

URI Query Parameters:

Name

Type

Is Required?

Description

filter[<filter_name>]

string, boolean

Optional

Filtering

include

string

Optional

Inclusion

sort

string

Optional

Inclusion

Includes:

Value

Description

order

Order Object

trunk

Trunk Object

trunk.trunk_group

Trunk Group Object

trunk.pop

POP Object

trunk_group

Trunk Group Object

capacity_pool

Capacity Pool Object

shared_capacity_group

Shared Capacity Group Object

did_group

DID Group 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.

pending_removal

boolean

No

No

The pending_removal 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.

trunk.id

string

Yes

Yes

The ID field of trunk relationship.

trunk_group.id

string

Yes

Yes

The ID field of 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.

Sorting:

Value

Sorts by:

blocked

The blocked field.

pending

The pending field.

awaiting_registration

The awaiting_registration field.

capacity_limit

The capacity_limit field.

description

The description field.

terminated

The terminated field.

number

The number field.

expires_at

The expires_at field.

channels_included_count

The channels_included_count field.

dedicated_channels_count

The dedicated_channels_count field.

created_at

The created_at field.

Examples

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": "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",
                "pending_removal": false,
                "dedicated_channels_count": 0
            },
            "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"
                    }
                },
                "trunk": {
                    "links": {
                        "self": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/relationships/trunk",
                        "related": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/trunk"
                    }
                },
                "trunk_group": {
                    "links": {
                        "self": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/relationships/trunk_group",
                        "related": "https://api.didww.com/v3/dids/ac40fb08-ac14-4a6c-8f20-fe650870c266/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"
                    }
                }
            }
        },
        {
            "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",
                "pending_removal": false,
                "dedicated_channels_count": 0
            },
            "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"
                    }
                },
                "trunk": {
                    "links": {
                        "self": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/relationships/trunk",
                        "related": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/trunk"
                    }
                },
                "trunk_group": {
                    "links": {
                        "self": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/relationships/trunk_group",
                        "related": "https://api.didww.com/v3/dids/b37f0fcf-24d0-4799-8e81-a69bcc889f2e/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"
                    }
                }
            }
        }
    ],
    "meta": {
        "total_records": 2,
        "api_version": "2017-09-18"
    },
    "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"
    }
}

Other Responses

Code

Success

Description

401

No

Unauthorized