> For the complete documentation index, see [llms.txt](https://outboundpro.gitbook.io/api-v1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://outboundpro.gitbook.io/api-v1/lead-enrich-batch/listar-jobs.md).

# Listar jobs

## Listar jobs de enriquecimento (com filtro por status e origem)

> Retorna paginação dos jobs de enriquecimento em massa criados pelo cliente,\
> tanto via API quanto via painel. Suporta filtros por status e origem.\
> \
> \### Quando usar\
> \- \*\*Dashboard de histórico\*\* — mostra ao usuário quantos processamentos rodaram, em qual estado.\
> \- \*\*Auditoria de uso de créditos\*\* — soma \`consumo\_total\_creditos\` dos jobs do mês.\
> \- \*\*Detecção de zumbis\*\* — filtra \`status=P\` há muito tempo (combinar com \`/get\` pra ver \`data\_inicio\`).\
> \- \*\*Separação API vs Painel\*\* — usa \`origem=api\` pra ver só jobs disparados por integração externa.\
> \
> \### Quando NÃO usar\
> \- \*\*Pra acompanhar UM job específico\*\* — use \`/get?id=N\`. List traz vários, mais pesado.\
> \
> \### Casos de uso reais\
> \- \*\*Relatório mensal pro PX\*\*: lista jobs do mês com \`origem=api\`, soma créditos consumidos, mostra economia vs uso manual antigo.\
> \- \*\*Health check no CRM\*\*: query a cada hora — se tem jobs em \`E\` recentes, manda alerta pro time técnico interno.\
> \- \*\*Recibo de fim-de-job\*\*: depois que webhook chega, busca os últimos 5 jobs pra mostrar histórico próximo ao usuário no app dele.\
> \
> Ordenação fixa: mais recentes primeiro (\`pms\_id DESC\`).<br>

```json
{"openapi":"3.0.3","info":{"title":"OutboundPro API","version":"2.0.0"},"tags":[{"name":"Lead","description":"**Empresas já existentes na sua base** (após enriquecimento via\n[Company](#tag/Company) ou cadastro manual no painel).\n\nO termo \"Lead\" no OutboundPro = \"empresa rastreada por você\". Cada lead tem\nstatus (Novo, Em prospecção, Convertido, etc.), lista vinculada, scoring\nautomático e contatos (sócios) associados.\n\n### Diferença Company × Lead\n- **Company** = empresa pelo CNPJ; consulta a base pública (RFB) do OutboundPro e pode salvar como lead.\n- **Lead** = consulta sua base local; **rápido**, sem lookup externo.\n\nSe você sabe que a empresa já está na sua base, prefira `lead/*` por\nperformance.\n\n### Estrutura típica\n- `id` (`emp_codigo`) ou `hash` (`emp_hash`) — identificadores estáveis.\n- `status` — fluxo configurável por cliente ([Status](#tag/Status)).\n- `lista` — agrupamento ([List](#tag/List)).\n- `contatos` — sócios ([Contact](#tag/Contact)).\n"}],"servers":[{"url":"https://app.outboundpro.com.br/api","description":"Produção"}],"security":[{"TokenAuth":[]}],"components":{"securitySchemes":{"TokenAuth":{"type":"apiKey","in":"header","name":"Token","description":"Chave privada do cliente (`cli_chave_privada`). Formato UUID v4\n(36 caracteres com hífens). Aceita header em qualquer case\n(`Token`, `token`, `TOKEN`).\n"}},"schemas":{"PaginacaoEnvelope":{"type":"object","required":["response","total","pagina","limite","paginas"],"properties":{"response":{"type":"string","enum":["success"]},"total":{"type":"integer","description":"Total geral (ignora paginação)."},"pagina":{"type":"integer","minimum":1},"limite":{"type":"integer","minimum":1,"maximum":100},"paginas":{"type":"integer","description":"Total de páginas considerando `limite` atual."}}},"ErrorResponse":{"type":"object","required":["response"],"properties":{"response":{"type":"string","enum":["error"]},"mensagem":{"type":"string","description":"Descrição do erro em pt-BR. Família Contact usa `message` (legado)."},"message":{"type":"string","description":"Equivalente inglês de `mensagem`, usado pela família Contact."}}}},"responses":{"Unauthorized":{"description":"Token ausente, inválido ou cliente inativo.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/lead-enrich-batch/list":{"get":{"tags":["Lead"],"summary":"Listar jobs de enriquecimento (com filtro por status e origem)","operationId":"leadEnrichBatchList","description":"Retorna paginação dos jobs de enriquecimento em massa criados pelo cliente,\ntanto via API quanto via painel. Suporta filtros por status e origem.\n\n### Quando usar\n- **Dashboard de histórico** — mostra ao usuário quantos processamentos rodaram, em qual estado.\n- **Auditoria de uso de créditos** — soma `consumo_total_creditos` dos jobs do mês.\n- **Detecção de zumbis** — filtra `status=P` há muito tempo (combinar com `/get` pra ver `data_inicio`).\n- **Separação API vs Painel** — usa `origem=api` pra ver só jobs disparados por integração externa.\n\n### Quando NÃO usar\n- **Pra acompanhar UM job específico** — use `/get?id=N`. List traz vários, mais pesado.\n\n### Casos de uso reais\n- **Relatório mensal pro PX**: lista jobs do mês com `origem=api`, soma créditos consumidos, mostra economia vs uso manual antigo.\n- **Health check no CRM**: query a cada hora — se tem jobs em `E` recentes, manda alerta pro time técnico interno.\n- **Recibo de fim-de-job**: depois que webhook chega, busca os últimos 5 jobs pra mostrar histórico próximo ao usuário no app dele.\n\nOrdenação fixa: mais recentes primeiro (`pms_id DESC`).\n","parameters":[{"in":"query","name":"pagina","schema":{"type":"integer","default":1},"description":"Página (1-based)."},{"in":"query","name":"limite","schema":{"type":"integer","default":50,"maximum":100},"description":"Itens por página (cap 100)."},{"in":"query","name":"status","schema":{"type":"string","enum":["A","P","C","E"]},"description":"Filtra por status. A=aguardando, P=em processamento, C=concluído, E=erro."},{"in":"query","name":"origem","schema":{"type":"string","enum":["painel","api"]},"description":"Filtra por origem: painel (criado pela tela) ou api (criado via /create)."}],"responses":{"200":{"description":"Jobs paginados.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/PaginacaoEnvelope"},{"type":"object","properties":{"jobs":{"type":"array","items":{"type":"object"}}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}}}}
```