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

Estado de un lote

Estado de un trabajo asíncrono y URL de descarga del resultado.

Alcance

Cualquier API key válida

Límite de uso

60 solicitudes por minuto

Devuelve el estado de un trabajo creado con POST /api/v6/numberinsight/batch. Cuando status es done, la respuesta incluye download.url, una URL de descarga temporal válida por 60 minutos con el NDJSON resultante.

El trabajo queda disponible unos 90 días desde su creación. Después responde 404.

Parámetros de ruta

jobId

stringobligatorio

UUID devuelto al crear el trabajo.

Respuestas

200

Estado del trabajo.

{
  "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

jobId vacío.

401

Credenciales inválidas o faltantes.

404

Trabajo no encontrado, de otra cuenta, vencido o ya purgado.

429

Se excedió el límite de solicitudes.

Errores posibles

Códigos que este endpoint puede devolver en error.code. El detalle completo está en el catálogo.

401AUTH_REQUIREDNo se envió un token Bearer y cada llamada lo requiere.401AUTH_INVALID_KEYLa API key no se reconoce: formato equivocado, revocada o vencida.400BAD_REQUESTNo pudimos interpretar tu petición.404NOT_FOUNDLa ruta que pediste no existe en esta API.429RATE_TPS_EXCEEDEDExcediste el cupo de tu organización para este endpoint.

Ver el catálogo completo

Alcance y límites

Parámetros de ruta

Respuestas

Errores posibles