Skip to content

Phone numbers

Numbers that answer the way you set them.

Find local, mobile and toll-free numbers by API, then decide where every call and text goes: a phone, your SIP server, an IVR menu or voicemail.

35

Countries with numbers in the store now

1,343

Number ranges you can choose from

$6.50

Lowest monthly price

per number

25

Destinations a number can ring

Overview

A number, and everything it does when someone calls

Phone numbers gives your app numbers people can call and text. Search the store, ask for the number with a line on how it will be used, and once it is approved point it at a phone, a SIP server or the call features built into the platform.

At a glance

Search
GET /dids/search
Request
POST /dids/requests
Your numbers
GET /dids/mine
Route calls
PUT /dids/{id}/routing
Auth
Bearer API key, numbers:read and numbers:write
Billing
Setup plus monthly, renewed from your balance

Capabilities

What a number can do

  • Search by digits

    Find ranges by the digits a number should start with or contain, by country and by type, with each SKU's setup and monthly price.

    GET /dids/search?pattern=…

  • Route calls anywhere

    Forward to a phone or a SIP server with a backup, or set an ordered call flow of up to 25 destinations that ring in turn or all at once.

    PATCH or PUT /dids/{id}/routing

  • Hosted SIP lines

    Create a SIP login on the number for a softphone or desk phone, with no server of your own.

    POST /dids/{id}/sip-lines

  • IVR menus

    A greeting and up to 12 key options, each sending the caller to a destination, voicemail or a polite goodbye.

    PUT /dids/{id}/features/ivr

  • Business hours

    Opening times per weekday in your time zone, holidays, and what happens outside hours.

    PUT /dids/{id}/features/schedule

  • Voicemail and recording

    Voicemail when nobody answers or always, with transcription. Call recording with an optional announcement and your own retention period.

    PUT /dids/{id}/features/voicemail, /recording

  • Two-way SMS

    On numbers that carry SMS, inbound texts are posted to your URL and you reply from the number.

    PUT /dids/{id}/sms-settings

  • Numbers for your customers

    Hold a number for one of your sub-accounts. It is billed to your balance, never theirs.

    subAccountId on the request

Find and request a number

Search, then ask for it

Search the store by digits, then file a request for the range you want with a sentence on how the number will be used. Nothing is charged until it is approved.

  • Every number is reviewed before purchase. Say what calls it will receive, who will call it and where it will be published.
  • On approval the setup and first month are charged and the number is ordered. It then appears in GET /dids/mine.
# 1. Search the store by digits. Each of data.hits has a groupId and SKUs with prices.
curl "https://packetexchange.io/api/v1/dids/search?pattern=4420&limit=5" \
  -H "Authorization: Bearer $PACKETEXCHANGE_API_KEY"

# 2. Ask for one, saying how it will be used. Nothing is charged until it is approved.
curl -X POST https://packetexchange.io/api/v1/dids/requests \
  -H "Authorization: Bearer $PACKETEXCHANGE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Idempotency-Key: $(uuidgen)" \
  -d '{
    "groupId": "<from the search>",
    "skuId": "<from the search>",
    "justification": "Inbound support line for our UK customers, published on our website and invoices."
  }'

Request response, data

{
  "id": "…",
  "status": "pending",
  "country": "United Kingdom",
  "setupPrice": "…",
  "monthlyPrice": "…"
}

Calls, routed your way

From one forward to a full call flow

Start by sending calls to a mobile. Add an IVR, opening hours, voicemail with transcription and recording when you need them, all on the number itself.

Webhooks

Events, signed and retried

Every call, text and voicemail on your numbers reaches your app as it happens.

Signed with an HMAC SHA-256 in X-PX-Signature and retried until your endpoint answers.

  • number.call.receivedA call arrived on a number you hold.
  • number.sms.receivedA text arrived on a number you hold.
  • number.voicemail.receivedA caller left a voicemail.
  • balance.lowYour balance fell below your threshold.

Pricing

A setup price and a monthly price

Each number lists both before you ask for it. Approval charges the setup and the first month; after that the number renews monthly from your balance until you release it or turn renewal off.

Local16 countries, some with no setup fee
from $6.50 a month
Mobile9 countries, some with no setup fee
from $6.50 a month
Toll-free22 countries, setup from $6.50
from $6.50 a month
National4 countries, some with no setup fee
from $6.50 a month
Shared Cost2 countries, setup from $29.90
from $29.90 a month

Read live from the number store as this page was served. Toll-free numbers also bill inbound calls per started minute.

In production

Built for production

A number here comes with the call handling most teams would otherwise build.

  • Call handling built inRouting to SIP or a phone with a backup target, an IVR menu, opening hours, voicemail with transcription and recording are settings on the number.
  • Reviewed and kept cleanEvery purchase is reviewed by our team before it is charged, with an identity check on the account, so numbers are not burned by abuse.
  • Prices before you askSetup and monthly prices are shown in the catalogue with every result, and renewal is automatic unless you switch it off.
  • Sized to its trafficEach number has a concurrent call capacity you can read and change.
  • Activity as eventsnumber.call.received, number.sms.received and number.voicemail.received report what reached each number, signed like every webhook.

Numbers you can see

Every number shows its monthly price before you ask for it.

Coming from Twilio

The names you know, mapped

If you have built on Twilio, most of what you know carries over. These are the pieces that change for this product.

TwilioAvailablePhoneNumbers searchHereGET /dids/searchSearch by digits with a pattern; prices come back with each result.
TwilioIncomingPhoneNumbers POST (instant purchase)HerePOST /dids/requests, then approvalEvery number is reviewed before it is charged and ordered.
TwilioVoiceUrl returning TwiMLHereRouting, IVR, hours and voicemail on the numberSet once by API; no webhook is asked what to do per call.
TwilioSmsUrlHereforwardWebhookUrl in sms-settingsInbound texts are posted to it; reply with POST /dids/{id}/messages.
TwilioPhoneNumber SID (PN…)HereNumber id (UUID)From GET /dids/mine.
TwilioSubaccount-owned numbersHeresubAccountId on the requestHeld for your customer and billed to your balance.

Twilio is a trademark of Twilio Inc. PacketExchange is not affiliated with or endorsed by Twilio.

Questions

Phone numbers, answered

Why does a number need approval?
Every number is reviewed before purchase so numbers go to genuine uses. Tell us what calls it will receive, who will call it and where it will be published. Nothing is charged until it is approved.
What do I pay?
The setup price and the monthly price shown on the number. Approval charges the setup and first month; it then renews monthly from your balance. Toll-free numbers also bill inbound calls per started minute.
Where can calls go?
To a phone, a SIP server, a hosted SIP line on the number, an IVR menu or voicemail, in an ordered call flow of up to 25 destinations that ring in turn or together.
Can a number receive texts?
Yes, on number types that carry SMS. Set a forwarding URL and inbound texts are posted to it as they arrive; reply from the number with one request.
Can I use a number as my caller ID?
Yes. Numbers you hold can be used as outbound caller IDs on your calls and campaigns.
Can I bring numbers I already have?
Not through the API today. Contact the team about numbers you hold elsewhere.

Find your number today

Free account, an API key on sign-up and every price listed before you ask. No contract.

Prefer to talk it through? Contact the team.