# 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-did-groups.html).

```
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-did-group.html).

```
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/index.html) | Countries used to filter DID Groups. |
| [Regions](../regions/index.html) | Regions used to filter DID Groups where region-level coverage applies. |
| [Cities](../city/index.html) | Cities used to filter DID Groups where city-level coverage applies. |
| [NANPA Prefixes](../nanpa/index.html) | NANPA prefixes used to filter North American DID inventory. |
| [DID Group Types](../did-group-type/index.html) | DID Group Types such as local, mobile, national, toll-free, shared cost, or global. |
| [Available DIDs](../available-did/index.html) | Specific DID phone numbers available for selection and reservation. |
| [DID Reservations](../did-reservation/index.html) | Reservations used before ordering a selected available DID phone number. |
| [Orders](../../inventory-resources/order/index.html) | Orders created using the selected Stock Keeping Unit `id` as `sku_id`. |
| [Common Definitions](../../common-definitions/index.html) | Shared embedded objects such as the Stock Keeping Unit Object. |

On this page