---
title: "List purchased DID numbers"
method: GET
path: "/api/v1/purchases"
tags: ["Purchases"]
---

# List purchased DID numbers

`GET /api/v1/purchases`

## Request

- Base URL: `https://app.didlogic.com`
- URL: `https://app.didlogic.com/api/v1/purchases`
- Auth: HTTP bearer

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

**Features:**
- Ordered by most recent first
- Pagination: 100 DIDs per page (max 1000)
- Available in JSON and CSV formats

**Returned Information:**
- DID number and status
- Purchase and expiration dates
- Monthly cost and features
- SMS/voice capabilities

`purchases[].number` feeds purchases_destinations_index, purchases_destinations_create,
purchases_destinations_update, purchases_destinations_destroy, numbers_purchase_destroy and
sms_create: it is the `purchase_id` of the destination operations, an entry of `did_numbers[]`
when releasing numbers, and `sm[source]` when the number has SMS enabled. See also: numbers_index,
the same numbers with their inventory id.

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

Successfully returns paginated list of purchased DID numbers in JSON format

- object
  - `purchases` object[], required: List of purchased DID numbers
    - `number` string, required: DID phone number
    - `channels` integer, required: Number of channels
    - `country` string, required: DID country
    - `area` string, required: DID area
    - `codec` unknown, required
    - `check_state` string, required: DID status
    - `free_minutes` integer, required: Free minutes included
    - `activation` number, float, required: Activation fee
    - `monthly_fee` number, float, required: Monthly cost for the DID
    - `per_minute` number, float, required: Per minute rate
  - `pagination` object, required
    - `pages` integer, required
    - `page` integer, required
    - `total_records` integer, required
    - `per_page` integer, required

## Other responses

- `403`: Returns 403 error when API token is incorrect

---

[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)