Get DID Groups

Returns a list of DID Groups, which is essentially a list of the current DIDWW coverage. DID Groups are phone numbers that share a common city or area code.

Request

HTTP Method: GET

URI Path: /v3/did_groups

Note

For all returned data attributes, see Did Group Object.

URI Query Parameters

Name	Type	Is Required?	Description
include	string	No	Inclusion
filter[<filter_name>]	string, boolean, Integer	No	Filtering
fields[did_groups]	string	No	Sparse fieldsets
sort	string	No	Sorting

Includes

Value	Description
country	Country Object
region	Region Object
city	City Object
did_group_type	DID Group Type Object
stock_keeping_units	A list of Stock Keeping Unit Objects
address_requirement	Address Requirement Object

Filters

Filter Name	Type	Allow Blank	Allow Array	Filters by:
id	string	No	Yes	Group id field.
prefix	string	Yes	Yes	The group prefix field.
nanpa_prefix.id	string	Yes	Yes	The nanpa prefix id field.
nanpa_prefix.npanxx	string	Yes	Yes	The nanpa prefix npa / nxx fields.
area_name	string	Yes	Yes	The area_name field (for example London). Case insensitive.
is_metered	boolean	No	No	The is_metered field.
allow_additional_channels	boolean	No	No	The allow_additional_channels field.
available_dids_enabled	boolean	No	No	The available_dids_enabled field.
features	string	No	Yes	The 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.
needs_registration	boolean	No	No	The needs_registration field.
is_available	boolean	No	No	The is_available field.
country.id	string	Yes	Yes	The country.id field.
region.id	string	Yes	Yes	The region.id field.
city.id	string	Yes	Yes	The city.id field.
did_group_type.id	string	Yes	Yes	The did_group_type.id field.
meta.total_count_gteq	Integer	Yes	No	A filter on the list based on the meta.total_count_gteq field, where gteq stands for greater-equal.

Sorting

Value	Sorts by:
country.name	The country.name field.
did_group_type.name	The did_group_type.name field.
prefix	City prefix field.
is_metered	The is_metered field.
area_name	The area_name field.
allow_additional_channels	The allow_additional_channels field.

Examples

Simple requestFilter by country.id, did_group_type.id - Include sku_idFilter by city.id, prefix - Include sku_idFilter by nanpa_prefix.idFilter by nanpa_prefix.npanxxFilter by id - With service restrictions

http

GET /v3/did_groups 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/did_groups -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": "ac160b14-e670-490f-b158-d3ba552c623f",
        "type": "did_groups",
        "attributes": {
            "prefix": "241",
            "features": [
                "voice_in",
                "voice_out",
                "t38"
            ],
            "is_metered": false,
            "area_name": "Aachen",
            "allow_additional_channels": true,
            "service_restrictions": null
        },
        "relationships": {
            "country": {
                "links": {
                    "self": "https://api.didww.com/v3/did_groups/ac160b14-e670-490f-b158-d3ba552c623f/relationships/country",
                    "related": "https://api.didww.com/v3/did_groups/ac160b14-e670-490f-b158-d3ba552c623f/country"
                }
            },
            "city": {
                "links": {
                    "self": "https://api.didww.com/v3/did_groups/ac160b14-e670-490f-b158-d3ba552c623f/relationships/city",
                    "related": "https://api.didww.com/v3/did_groups/ac160b14-e670-490f-b158-d3ba552c623f/city"
                }
            },
            "did_group_type": {
                "links": {
                    "self": "https://api.didww.com/v3/did_groups/ac160b14-e670-490f-b158-d3ba552c623f/relationships/did_group_type",
                    "related": "https://api.didww.com/v3/did_groups/ac160b14-e670-490f-b158-d3ba552c623f/did_group_type"
                }
            },
            "region": {
                "links": {
                    "self": "https://api.didww.com/v3/did_groups/ac160b14-e670-490f-b158-d3ba552c623f/relationships/region",
                    "related": "https://api.didww.com/v3/did_groups/ac160b14-e670-490f-b158-d3ba552c623f/region"
                }
            },
            "stock_keeping_units": {
                "links": {
                    "self": "https://api.didww.com/v3/did_groups/ac160b14-e670-490f-b158-d3ba552c623f/relationships/stock_keeping_units",
                    "related": "https://api.didww.com/v3/did_groups/ac160b14-e670-490f-b158-d3ba552c623f/stock_keeping_units"
                }
            },
            "address_requirement": {
                "links": {
                    "self": "https://api.didww.com/v3/did_groups/ac160b14-e670-490f-b158-d3ba552c623f/relationships/address_requirement",
                    "related": "https://api.didww.com/v3/did_groups/ac160b14-e670-490f-b158-d3ba552c623f/address_requirement"
                }
            }
        },
        "meta": {
            "available_dids_enabled": false,
            "needs_registration": true,
            "is_available": true,
            "total_count": 21
        }

    }],
    "meta": {
        "total_records": 1,
        "api_version": "2026-04-16"
    },
    "links": {
        "first": "https://api.didww.com/v3/did_groups?page%5Bnumber%5D=1&page%5Bsize%5D=50",
        "last": "https://api.didww.com/v3/did_groups?page%5Bnumber%5D=32&page%5Bsize%5D=50"
    }
}

Other Responses

Code	Success	Description
401	No	Unauthorized