DID Groups

Use the DID Groups resource to retrieve DID inventory groups available in the DIDWW coverage catalog.

A DID Group represents a group of DID phone numbers that share common coverage characteristics, such as country, region, city, area, prefix, DID Group Type, features, availability, pricing options, and registration requirements.

DID Groups are commonly used before creating an order. Use them to find available DID phone number inventory, retrieve related Stock Keeping Unit data, check whether registration is required, and select the correct sku_id for DID ordering.

Endpoints

Action	Method	Endpoint
Retrieve all DID Groups	GET	/v3/did_groups
Retrieve DID Group	GET	/v3/did_groups/{id}

Retrieve all DID Groups

Retrieves all DID Groups available in the DIDWW coverage catalog.

Use this endpoint to search DID inventory by country, region, city, area, DID Group Type, prefix, features, registration requirements, or availability.

See Retrieve All DID Groups.

GET /v3/did_groups

Retrieve DID Group

Retrieves a specific DID Group by its unique ID.

Use this endpoint when you already know the DID Group ID and need to retrieve its coverage details, relationships, pricing options, or availability metadata.

See Retrieve DID Group.

GET /v3/did_groups/{id}

Common DID Group use cases

Use case	Description
Search DID inventory	Find DID Groups available in a selected country, region, city, area, or prefix.
Check DID availability	Use availability metadata to determine whether DID phone numbers are currently available for purchase.
Filter by DID Group Type	Use DID Group Types to find local, mobile, national, toll-free, shared cost, or global DID inventory.
Select a SKU	Include Stock Keeping Units and use the selected Stock Keeping Unit id as sku_id when creating an order.
Check registration requirements	Check whether a DID Group requires address verification before activation.
Enable number selection	Use DID Groups that support available DID selection before retrieving specific available DID phone numbers.
Prepare an order	Use DID Group coverage, pricing, registration, and SKU data before creating a DID order.

Related resources

Use the DID Group ID and related resource IDs to continue DID inventory and ordering flows.

Resource	Description
Countries	Countries used to filter DID Groups.
Regions	Regions used to filter DID Groups where region-level coverage applies.
Cities	Cities used to filter DID Groups where city-level coverage applies.
NANPA Prefixes	NANPA prefixes used to filter North American DID inventory.
DID Group Types	DID Group Types such as local, mobile, national, toll-free, shared cost, or global.
Available DIDs	Specific DID phone numbers available for selection and reservation.
DID Reservations	Reservations used before ordering a selected available DID phone number.
Orders	Orders created using the selected Stock Keeping Unit id as sku_id.
Common Definitions	Shared embedded objects such as the Stock Keeping Unit Object.