---
title: "List purchased numbers"
method: GET
path: "/api/v2/numbers"
tags: ["Numbers & Inventory"]
---

# List purchased numbers

`GET /api/v2/numbers`

## Request

- Base URL: `https://app.didlogic.com`
- URL: `https://app.didlogic.com/api/v2/numbers`
- Auth: HTTP bearer

Retrieve a list of DID numbers purchased by the authenticated user.

**Important notes:**
- Returns only active numbers by default
- Use `show_all=true` to include numbers pending document approval
- Includes service information (SMS, etc.)
- Shows current status of each number

**When to use:**
- Displaying user's number inventory
- Checking number status
- Listing numbers for configuration
- Dashboard display

`dids[].id` feeds numbers_purchase_update and numbers_purchase_destroy (`id`, `id_in[]`).
`dids[].number` feeds numbers_purchase_destroy (`did_numbers[]`). `dids[].id` feeds
purchases_destinations_index, purchases_destinations_create, purchases_destinations_update and
purchases_destinations_destroy (`purchase_id`, which takes the number too). `dids[].identity_id`
feeds identities_index and numbers_purchase_update (`ids`, `identity_id`). See also: purchases_index.

## Query parameters

- `show_all` string

## Response `200`

returns DIDs

- object
  - `dids` object[], required: List of DID numbers owned by the user
    - `id` integer, required: Unique DID identifier
    - `number` string, required: Phone number
    - `country` string, required: Country name where the number is located
    - `area` string, required: City or area name
    - `channels` integer, required: Number of simultaneous call channels
    - `activation` number, float, required: One-time activation fee
    - `monthly_fee` number, float, required: Monthly recurring fee
    - `per_minute` number, float, required: Per-minute rate for incoming calls
    - `services` string[], required: List of enabled services (e.g., sms)
    - `status` 'active' | 'pending_docs', required: Current status of the number
    - `destination_count` integer, required: Number of configured routing destinations
    - `call_recording_enabled` boolean, required
    - `commitment_months` integer, required: Minimum commitment period in months
    - `identity_id` integer, required: Associated identity/document ID for verification

## Other responses

- `401`: returns unauthorized

---

[API](https://skmtc.dev/didlogic/apis/get-started.md) · [All operations](https://skmtc.dev/didlogic/apis/get-started/llms.txt) · [OpenAPI document](https://skmtc.dev/didlogic/apis/get-started/revisions/dc972d592b34?raw)