API & Data

Built on carrier data, one number at a time.

The bulk data files are gone. A per-search API replaces them, and it is not open yet. This page says which is which, because docs that overstate what works cost you more time than no docs at all.

+1
ComingPer-search lookupCurrent carrier after porting, line type, port date, LRN. US, Canada and toll-free.
WithdrawnBulk data filesThe 423-area-code JSON set now returns 410. NANPA and the CNA publish the source, free.
How to get inAsk, and a person reads itNo instant keys. Tell us the use case and we will email you when it opens.

Where the data stands today

Until recently every compiled data file on this site was a public URL: the full numbering plan, the carrier index, rate centres, the lot. No key, no limit, and the whole set came down in a few hundred requests. That was never a considered decision, and it has been withdrawn — those paths now return 410 Gone.

What replaces it is a per-search API: you ask about a number or a prefix and get an answer, rather than taking a copy of the database. It is not open yet. The form below is how you get on the list, and it is read by a person.

What the API will answer

The same questions the lookup on this site already answers, which is a useful way to judge whether it is worth your time — try it on a real number before you fill anything in.

  • Current carrier after porting, not just who the prefix was assigned to. For roughly two thirds of prefixes those differ, because the prefix is thousands-block pooled or the number has moved.
  • Line type — wireless, landline, fixed or non-fixed VoIP.
  • Porting history — whether it moved, when, and from whom.
  • Network identifiers — LRN, OCN, rate centre, LATA.
  • US, Canada and toll-free. The provider answers for all three.

What it will not do

Worth saying plainly, because it decides whether this is useful to you.

  • No bulk export. That is the whole point of the change. If you need a copy of the numbering plan itself, NANPA publishes the US source and the CNA publishes the Canadian one — both free, both authoritative, and we would rather point you there than pretend otherwise.
  • No people data. No names, no addresses, no subscriber records. This is carrier and routing data. It always has been.

Ask for access

Tell us what you are building. Volume and timing help us size it, and a real description of the use case matters more than the numbers — we would rather understand ten integrations than hand out a thousand keys.

Stored so we can contact you about the API. Not sold, not shared, not added to a mailing list. We do not log IPs, user agents or cookies anywhere on this site.

Questions

Developer questions, answered.

When does the API open?
No date yet, and we would rather say that than invent one. Ask below and you will hear from us when it does — we are not running a drip campaign, it is one email.
Why did the free data files go away?
They were never meant to be a bulk download. The entire compiled dataset was public, uncapped and cross-origin, so anyone could take a complete copy in a few hundred requests. A per-search API answers real questions without handing over the database.
I was using the JSON files. What now?
They return 410 rather than 404, so your client can tell the difference between 'withdrawn' and 'typo'. Ask for API access below. If what you actually need is the raw numbering plan, go to NANPA (US) and the CNA (Canada) — that is where ours comes from and it is free at source.
Is the area-code and carrier data on the site still free to read?
Yes. Every directory page is public and always will be. What changed is that you cannot take the compiled set in one request.
Will it cost money?
Probably, because each lookup costs us money at the provider. Pricing is not set. If you tell us your volume it helps work that out.
Do you sell or share what I put in the form?
No. It is stored so we can contact you about the API, and it is visible only to us on an access-controlled page. We do not log your IP, user agent or cookies anywhere on this site, and the form is no exception.
What does “pooled” mean, and why does it matter?
A prefix is 10,000 numbers, but it can be split into ten blocks of 1,000 held by different carriers. About 63% of prefixes are pooled, which is exactly why a prefix-level answer is not good enough and a per-number lookup is worth paying for.

New to how this data is assembled? Read how we get our data. Want to see the lookup answer a real number first? Try the carrier lookup or the LRN lookup.

Part of the PhoneNumbers.com Network

Looking for a number of your own?
Local, toll-free and vanity numbers, ready to buy.

Explore PhoneNumbers.com