Purchases

List purchased DID numbers

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.

get/api/v1/purchases

Request

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

Query parameters

pageinteger

Page number for pagination (starts from 1)

per_pageinteger

Number of items per page

Response

Successfully returns paginated list of purchased DID numbers in JSON format

Example response

{
  "purchases": [
    {
      "number": "1234567890",
      "channels": 1,
      "country": "Fake country for 1234567890",
      "area": "Fake city for 1234567890",
      "check_state": "active",
      "activation": 1.17,
      "monthly_fee": 1.17,
      "per_minute": 0.117
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.