# Available DIDs

Use the Available DIDs resource to retrieve DID phone numbers that are currently available
in the DIDWW inventory.

An Available DID represents a specific DID phone number that can be selected before
ordering. Available DIDs are used when a DID Group supports number selection and the
customer needs to choose a specific phone number instead of ordering from a DID Group
without selecting the number.

Available DIDs are commonly used before creating a DID Reservation or an order. Use them
to search available phone numbers, select a specific DID, reserve it when required, and
continue the DID ordering flow.

Note

Available DID requests are not enabled by default. To request access to this feature,
contact DIDWW Customer Service or Sales.

## Endpoints

| Action | Method | Endpoint |
| --- | --- | --- |
| Retrieve all Available DIDs | `GET` | `/v3/available_dids` |
| Retrieve Available DID | `GET` | `/v3/available_dids/{id}` |

## Retrieve all Available DIDs

Retrieves all Available DIDs matching the request filters.

Use this endpoint to search specific DID phone numbers that are currently available for
selection and reservation.

See [Retrieve All Available DIDs](get-available-dids.html).

```
GET /v3/available_dids
```

## Retrieve Available DID

Retrieves a specific Available DID by its unique ID.

Use this endpoint when you already know the Available DID ID and need to retrieve details
for a selected phone number before reservation or ordering.

See [Retrieve Available DID](get-available-did.html).

```
GET /v3/available_dids/{id}
```

## Common Available DID use cases

| Use case | Description |
| --- | --- |
| Search selectable DID numbers | Retrieve specific DID phone numbers that are currently available in DIDWW inventory. |
| Select a phone number before ordering | Use Available DIDs when a customer needs to choose a specific DID phone number. |
| Prepare a DID reservation | Use the selected Available DID before creating a DID Reservation, when reservation is required. |
| Continue the ordering flow | Use the selected DID number together with DID Group and Stock Keeping Unit data before creating an order. |
| Check number-level availability | Confirm that a specific DID phone number is still available before reservation or ordering. |

## Related resources

Use Available DID IDs and related DID Group data to continue DID inventory and ordering
flows.

| Resource | Description |
| --- | --- |
| [DID Groups](../did-group/index.html) | DID inventory groups used to find coverage, availability, pricing options, and number selection support. |
| [DID Reservations](../did-reservation/index.html) | Reservations created before ordering a selected Available DID phone number. |
| [Orders](../../inventory-resources/order/index.html) | Orders created after selecting or reserving an Available DID number. |
| [Countries](../countries/index.html) | Countries used to filter DID inventory and coverage. |
| [Regions](../regions/index.html) | Regions used to filter DID inventory where region-level coverage applies. |
| [Cities](../city/index.html) | Cities used to filter DID inventory where city-level coverage applies. |
| [NANPA Prefixes](../nanpa/index.html) | NANPA prefixes used to filter North American DID inventory. |
| [Common Definitions](../../common-definitions/index.html) | Shared embedded objects such as the Stock Keeping Unit Object. |

On this page