Enriquecimento

Status do lote em massa

GETgratuito

Progresso e resultado do lote. Enquanto roda, responde com retry_after_seconds (e o header Retry-After) — consulte nesse ritmo. No fim traz download_url (CSV, válido por 5 min; peça de novo para renovar) e a lista em list_id.

stalled = o lote parou numa etapa que precisa de conciliação: só o que foi entregue foi cobrado (credits_used) e a reserva do restante é liberada automaticamente quando vence. Reenviar o mesmo lote cobra de novo o que já foi entregue — envie só os itens que faltam.

Rate limit: 60 req/min

01

Testar ao vivo

Parâmetros

job_id devolvido pelo POST

Autorização

Sua API key, gerada em /developer/api-keys. Gratuita para começar.

Sua requisição

curl -X GET 'https://tamz.ai/api/v1/enrichment/bulk/{id}' \
  -H 'Authorization: Bearer tamz_SUA_API_KEY'
02

Exemplo de retorno

{
  "job_id": "453bd7d7-5355-4d6d-a38e-d9e7eb218c3f",
  "status": "queued",
  "progress_pct": 0,
  "delivered": 0,
  "no_data": 0,
  "unavailable": 0,
  "credits_used": 0,
  "pricing": "per_item",
  "list_id": "430bbdbc-9d7f-4d06-a273-67ca4ba4ae4b",
  "download_url": "string",
  "download_expires_at": "2019-08-24T14:15:22Z",
  "note": "string",
  "retry_after_seconds": 0
}
{
  "error": {
    "code": "INVALID_ID",
    "message": "job_id inválido"
  }
}
Empty
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Execução indisponível"
  }
}
Empty
03

Respostas e códigos

Response Body

application/json

application/json

application/json

Começar grátis