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."
}'import { randomUUID } from 'node:crypto';
const auth = { Authorization: `Bearer ${process.env.PACKETEXCHANGE_API_KEY}` };
// 1. Search the store by digits.
const search = await fetch('https://packetexchange.io/api/v1/dids/search?pattern=4420&limit=5', { headers: auth })
.then((r) => r.json());
const hit = search.data.hits[0];
// 2. Ask for it. Nothing is charged until it is approved.
const res = await fetch('https://packetexchange.io/api/v1/dids/requests', {
method: 'POST',
headers: { ...auth, 'Content-Type': 'application/json', 'X-Idempotency-Key': randomUUID() },
body: JSON.stringify({
groupId: hit.groupId,
skuId: hit.skus[0].skuId,
justification: 'Inbound support line for our UK customers, published on our website and invoices.',
}),
});
const { data } = await res.json();
console.log(data.id, data.status, data.monthlyPrice); // "pending"import os, uuid
import httpx
px = httpx.Client(
base_url="https://packetexchange.io/api/v1",
headers={"Authorization": f"Bearer {os.environ['PACKETEXCHANGE_API_KEY']}"},
)
# 1. Search the store by digits.
hit = px.get("/dids/search", params={"pattern": "4420", "limit": 5}).json()["data"]["hits"][0]
# 2. Ask for it. Nothing is charged until it is approved.
req = px.post(
"/dids/requests",
json={
"groupId": hit["groupId"],
"skuId": hit["skus"][0]["skuId"],
"justification": "Inbound support line for our UK customers, published on our website and invoices.",
},
headers={"X-Idempotency-Key": str(uuid.uuid4())},
).json()["data"]
print(req["id"], req["status"], req["monthlyPrice"]) # "pending"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.
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?
What do I pay?
Where can calls go?
Can a number receive texts?
Can I use a number as my caller ID?
Can I bring numbers I already have?
Keep reading
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.


