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

Simple RequestRequest with did_group Include

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