Full Examples

Copy and run these cURL examples — replace zn_live_xxxxxxxxxxxx and parameters.

1. Get balance

curl -X GET "https://app.zelnum.com/api/v1/balance" \
  -H "X-API-Key: zn_live_xxxxxxxxxxxx"

2. Submit detection

curl -X POST "https://app.zelnum.com/api/v1/detect" \
  -H "X-API-Key: zn_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "product": "YOUR_PRODUCT_SLUG",
    "country": "CN",
    "phones": ["+8613800138000", "+8613900139000"]
  }'

3. Upload file

curl -X POST "https://app.zelnum.com/api/v1/detect/file" \
  -H "X-API-Key: zn_live_xxxxxxxxxxxx" \
  -F "product=YOUR_PRODUCT_SLUG" \
  -F "country=CN" \
  -F "file=@/path/to/numbers.txt"

4. Poll task status

curl -X GET "https://app.zelnum.com/api/v1/tasks/xKj9aP3qLm7v" \
  -H "X-API-Key: zn_live_xxxxxxxxxxxx"

5. Get download URL

curl -X GET "https://app.zelnum.com/api/v1/tasks/xKj9aP3qLm7v/result" \
  -H "X-API-Key: zn_live_xxxxxxxxxxxx"