Skip to content

Twitter CheckNumber

task_type=twitter

Input and limits

international phone numbers. Upload a text file with one value per line. Use only identifiers you are authorized to process. Include the country code; E.164 format is recommended.

Minimum upload: 1. Maximum upload: 10,000,000. Minimum billable quantity: 500. Upload minimum and billing minimum are distinct; a small accepted upload may still incur the billing floor. Zero means no billing floor. A wholly failed or unprocessed task is not charged a fabricated minimum. Check current account pricing before submission.

Create a task

Terminal window
curl --request POST 'https://api.checknumber.ai/v1/tasks' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --form 'file=@input.txt' \
  --form 'task_type=twitter'

Poll and download

Keep the returned task_id. Poll until status=exported, then download result_url. pending and processing are incomplete; stop on failed. Never automatically repeat task creation after a timeout: the first request may already have created a task.

Terminal window
curl --request POST 'https://api.checknumber.ai/v1/gettasks' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --form 'task_id=YOUR_TASK_ID'

CSV columns

number,activated

Preserve column order and case. Empty or undetermined values are not a confirmed negative.

Authentication and errors

Use the X-API-Key header with a server-side key. 400: invalid input; 401: invalid key; 402: insufficient balance; 404: task not found; 413: oversized file. Retry safe status reads with capped backoff; preserve the original task ID.

Current pricing

Contract reviewed: 2026-10-30. Limits can change; consult the dashboard before submitting.