USACallerLookup Free Phone Lookup API
A free, read-only JSON API over US phone numbering data and FTC Do Not Call complaint records. No API key, no sign-up, no cost. Data sources: the NANPA…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
A free, read-only JSON API over US phone numbering data and FTC Do Not Call complaint records. No API key, no sign-up, no cost.
Data sources: the NANPA numbering registry (carrier, city and state per NPA-NXX prefix) and FTC Do Not Call complaint data (US public domain, refreshed every weekday), plus counts of moderated community reports filed on usacallerlookup.com. The data is dedicated to the public domain under CC0.
Rate limit: 60 requests per minute per IP. Above that the API answers HTTP 429 with a Retry-After header. Responses carry Cache-Control headers, so cache on your side. For bulk access download the full dataset (GitHub, Kaggle, Hugging Face, Zenodo) instead of crawling the API.
A complaint record means someone reported receiving an unwanted call that displayed the number. It is not proof of wrongdoing, and caller ID spoofing means the displayed number may not be the one that placed the call. USACallerLookup is not a consumer reporting agency under the FCRA, and this API must not be used to determine eligibility for credit, employment, housing or any other FCRA-regulated purpose.
Endpoints 3
Numbers
- GETLook up one US phone number
/number/:phoneReturns the number's assigned city, state and carrier, its FTC complaint profile (total complaints, robocall flags, first and last reported dates, number of…
Area codes
- GETSummarise one area code
/area-code/:npaPrefixes assigned, the top 10 cities holding them, and how many numbers in the area code appear in FTC complaint records. Cached for 12 hours.
Dataset
- GETDataset headline figures
/statsTracked numbers, complaint records, robocall-flagged records and when the data was last refreshed. Cached for 12 hours.
API details
- Base URL
https://www.usacallerlookup.com/wp-json/ucl/v1- Authentication
- None declared in the description
- Operations
- 3 operations on 3 pathsGET 3
- Main resources
- Area codes 1Dataset 1Numbers 1
- Response formats
application/json- Description format
- OpenAPI 3.1.0, API version
1.0.0 - Links
- Documentation · OpenAPI document · Terms of service · Support
How to test the USACallerLookup Free Phone Lookup API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the USACallerLookup Free Phone Lookup API collection, without the publisher's secrets.
- Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
- Send a requestPick an endpoint, for example “Look up one US phone number” (GET /number/:phone), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the USACallerLookup Free Phone Lookup API?
A free, read-only JSON API over US phone numbering data and FTC Do Not Call complaint records. No API key, no sign-up, no cost. Data sources: the NANPA… It is listed under Communication and has 3 endpoints.
Who publishes the USACallerLookup Free Phone Lookup API?
It is listed from Usacallerlookup's public API description (an OpenAPI document), not published by Usacallerlookup on Swastik Codes. Anyone who controls usacallerlookup.com can claim the profile by adding a DNS TXT record.
What is the base URL of the USACallerLookup Free Phone Lookup API?
Requests go to https://www.usacallerlookup.com/wp-json/ucl/v1. Endpoint paths are added to this base URL.
How do I authenticate with the USACallerLookup Free Phone Lookup API?
Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.
How many endpoints does the USACallerLookup Free Phone Lookup API have?
3 operations on 3 paths (3 GET). The largest groups are Area codes, Dataset, Numbers.
Is forking the USACallerLookup Free Phone Lookup API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.