Dedicated Numbers

Get a dedicated number with its messages

Returns a single dedicated number owned by the authenticated user, including paginated SMS messages received on the number. Use messages_before and messages_limit to page through message history (newest-first fetch, returned in ascending order).

If a renewal landed before it could be paid, payment_due shows the amount owed. It is collected automatically as soon as the balance covers it. SMS received meanwhile are stored but withheld (text/code null, content_withheld: true) until it is paid, and stay withheld if the period ends unpaid.

get/dedicated/numbers/{id}

Request

  • Base URL: https://dashboard.voidmob.com/api/v1
  • URL: https://dashboard.voidmob.com/api/v1/dedicated/numbers/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

Dedicated number id prefixed ded_.

Query parameters

messages_limitinteger

Maximum number of messages to return (1-100, default 50).

messages_beforestring

Cursor for paging older messages. Pass a msg_<id> value to retrieve messages before that id.

Response

Dedicated number detail with inline messages.

successtrue required

Example response

{
  "data": {
    "id": "ded_abc123",
    "display_id": "DED1",
    "phone_number": "+4915123456789",
    "country": "de",
    "country_name": "Germany",
    "quoted_price_cents": 3499,
    "charged_price_cents": 3499,
    "next_renewal_price_cents": 3499,
    "payment_due": {
      "amount_cents": 1499
    }
  }
}

Changes

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