Account recovery
Reset a password with the account phone, then sign in again before investigating balance, history, or API keys.
Support
Resolve an NumDetect account or API issue
Start with the error code or affected workflow, follow the recommended check, and contact support only when the documented next step does not resolve it.
Reset your password
API request reference
Confirm the X-API-Key header, the selected bulk product code, the uploaded file, the task response, and the published error codes.
Payments and balance
Compare credited balance, task charges, payment methods, and the automatic refund rule before opening a payment enquiry.
Error guide
What should you do for each API error?
Use the HTTP status and response code together. Remove secrets before sharing a response with support.
| Status / code | Meaning | Next action |
|---|---|---|
| 401 / 40100 | The API key is missing or invalid. | Send X-API-Key, confirm you copied the active key, and create a replacement in Settings if the original is unavailable. |
| 402 / 40200 | The account does not have enough balance to submit this bulk task. | Check the product price and available balance, then top up or submit a smaller file. |
| 429 / 42901 | The account already has the maximum number of bulk tasks being submitted or processed. | Wait for the Retry-After seconds, then submit the file again after an in-flight task finishes. The rejected request is not charged. |
| 503 / 50303 | The platform has reached its current bulk-task capacity. | Wait for the Retry-After seconds and resubmit the file. Nothing was charged. |
| 400 / 40000 | A bulk task file failed the precheck: empty, wrong format, below the 1,000-number minimum, over the 100,000 maximum, or containing lines that are not valid phone numbers for the selected country. | Fix the file as the error describes and submit again. The precheck runs before any charge, so this attempt cost nothing. |
| 409 / 40901 | The task has not finished, or its result link is not available yet. | Wait for the task to reach success, then download its result file from the task page or query the task again. |
| 504 / 50400 | The bulk task did not finish within its 300-second timeout. | Submit the whole file again. The timed-out task is refunded in full. |
| 503 / 50300 | The bulk-task service is temporarily unavailable or under maintenance. | Do not treat the file as processed. Try submitting it again later; a failed task is refunded. |
Before contacting support
Include the details that identify the request
Useful context shortens investigation time without requiring passwords or API key values.
- AccountThe phone associated with the workspace.
- RequestThe bulk-task ID, selected product code, and approximate submission time.
- ResponseThe API error code and message, with secrets removed.
Faster support checklist
Most account and API issues can be resolved faster when your message includes the account phone, bulk-task ID, product code, request time, and a redacted response body.
Contact: support@numdetect.com