Phone Numbers

List your numbers

Your numbers, newest first. Every filter is applied server-side and they combine (AND).

get/api/v1/numbers

Request

  • Base URL: https://api.callnode.io
  • URL: https://api.callnode.io/api/v1/numbers
  • Auth: API key in header X-Api-Key and API key in header X-Timestamp and API key in header X-Signature

Query parameters

statusstring

Filter by status, e.g. active.

type'local' | 'tollfree'
purchaseSource'web' | 'api'

Numbers bought via the dashboard (web) or this API (api).

tagstring

Numbers carrying this exact tag (as stored; up to 24 characters).

qstring

Substring match on the number's digits, the friendly name (case-insensitive), or a tag.

Response

Your numbers, newest first.

countinteger

Example response

{
  "numbers": [
    {
      "id": "cmpxeh9o60002pp4h7oznictb",
      "phoneNumber": "+16135551234",
      "status": "active",
      "tags": [
        "support",
        "east-coast"
      ],
      "monthlyRate": 1.99,
      "perMinuteRate": 0.02
    }
  ]
}

Changes

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