Asynchronous bulk phone-number enrichment.
Upload a phone-number list, pick one product and one country, and download a structured result file when the task finishes. NumDetect is a bulk workflow — there is no real-time single-number endpoint.
Website · API documentation · Pricing · Get an API key
One repository per product, each mirroring its own product page.
| Repository | Shape | Product code | Contents |
|---|---|---|---|
| Bulk Number Activity | Bulk (async) | number_activity_batch |
Input: phone · OpenAPI contract, product.json, llms.txt, examples in 7 languages |
| Bulk Global Carrier Lookup | Bulk (async) | global_carrier_batch |
Input: phone · OpenAPI contract, product.json, llms.txt, examples in 7 languages |
| Bulk E-commerce Active | Bulk (async) | number_ecommerce_batch |
Input: phone · OpenAPI contract, product.json, llms.txt, examples in 7 languages |
| Bulk High-Value Users | Bulk (async) | number_high_value_batch |
Input: phone · OpenAPI contract, product.json, llms.txt, examples in 7 languages |
| Bulk Phone Number Validation | Bulk (async) | number_validation_batch |
Input: phone · OpenAPI contract, product.json, llms.txt, examples in 7 languages |
| numdetect-resources | — | — | Technical notes, guides and announcements |
Every example repository carries a machine-readable product.json, an llms.txt summary for AI clients, an OpenAPI 3.0 contract, and runnable examples in Python, Node.js, Go, Java, C#, PHP and Shell. All request paths, response fields and limits are taken from the live product pages and the published API documentation.
POST /api/v1/bulk-tasks takes a .txt/.csv file of 500–100,000 numbers, returns a task id immediately, and produces a downloadable result file. There is no realtime single-number endpoint on this brand — a task is the product. One task carries one product and one country. Poll no more often than once every 30 seconds.
Every product on NumDetect uses the same API key, the same X-API-Key header and the same code / msg / data envelope, and draws from the same account balance.
Results are point-in-time signals: they describe what a provider reported at the moment of the check. They are not identity verification, not proof of ownership, and not permission to contact anyone. Use the API only for identifiers you are authorized to process, and comply with applicable privacy laws and platform terms. Third-party trademarks belong to their respective owners; no affiliation or endorsement is implied.