GET/api/v6/numberinsight/batch/{jobId}

Batch job status

State of an asynchronous job and the download URL of its result.

Scope

Any valid API key

Usage limit

60 requests per minute

Returns the state of a job created with POST /api/v6/numberinsight/batch. When status is done, the response includes download.url, a temporary download URL valid for 60 minutes with the resulting NDJSON.

The job stays available for about 90 days from creation. After that it returns 404.

Path parameters

jobId

stringrequired

UUID returned at job creation.

Responses

200

Job state.

{
  "success": true,
  "data": {
    "jobId": "4e2c8b91-3f12-4ad6-9b91-09e8e9c5e7a1",
    "status": "done",
    "count": 12450,
    "processed": 12450,
    "createdAt": "2026-06-18T09:00:00Z",
    "expiresAt": "2026-09-15T14:00:00Z",
    "download": {
      "url": "https://developers.hablame.co/api/v6/numberinsight/downloads/4e2c8b91.ndjson?expires=1789000000&signature=...",
      "format": "ndjson"
    }
  },
  "meta": {
    "requestId": "b9b1704baffab21150213c02fd853975",
    "timestamp": "2026-06-02T19:43:59+00:00",
    "responseTimeMs": 4.1
  }
}

400

Empty jobId.

401

Invalid or missing credentials.

404

Job not found, owned by another account, expired or already purged.

429

Request limit exceeded.

Possible errors

Codes this endpoint can return in error.code. The full detail lives in the catalog.

401AUTH_REQUIREDNo Bearer token was sent, and every call requires one.401AUTH_INVALID_KEYThe API key is not recognized: wrong format, revoked or expired.400BAD_REQUESTWe could not parse your request.404NOT_FOUNDThe path you requested does not exist in this API.429RATE_TPS_EXCEEDEDYou exceeded your organization quota for this endpoint.

See the full catalog

Scope and limits

Path parameters

Responses

Possible errors