DEVELOPER TOOLS · V2
Explore and test the V2 API
Choose an endpoint, select an example and send a request. The same OpenAPI contract powers this reference and the Postman collection.
Before your first request
1. Choose your access
Click Authorize and enter your existing API key under BearerAuth, without the Bearer prefix. Leave it empty to use the shared IP trial: 10 credits per 24-hour window. Your key is not saved by this page.
2. Try an example
Open an operation, click Try it out, then Execute. Start with GET /api/v2/usage to check your access mode and balance for free. Sample responses are illustrative.
3. Continue in Postman
Import the collection and environment below. Set apiKey in your private environment; baseUrl is already configured. Blank or unrecognized keys use the IP trial, so check meta.access.mode.
These are live requests. Ordinary lookups cost 1 credit, including automatic AI fallback and unknown results. Nickname mode (forceToGenderize) costs 1 for a dataset result or 2 for AI; explicit AI costs 2. Batch items are billed individually and phone validation costs 1. Each repeat is a new operation. See credit rules →
Loading the interactive API reference…