# Consulta o status de documentos e das extrações (Captura)

Consulta, para um ou mais documentos enviados à IA Captura, o status do processamento do documento e o status da captura (extração) gerada a partir dele. Um documento pode ser processado sem gerar captura — nesse caso, os campos da captura retornam vazios. Como o processamento é assíncrono, a orientação é consultar periodicamente (polling) até que os status cheguem a um estado final.

Endpoint: GET /v1/captura/documentos/status
Version: v1
Security: BearerAuth

## Security:

  - `BearerAuth` (unknown)
    apiKey in header Authorization

## Query parameters:

  - `ids` (array, required)
    IDs dos documentos a serem consultados (máximo 20)

  - `pagina` (integer)
    Número da página (padrão 1)

  - `tamanho_pagina` (integer)
    Tamanho da página (padrão 10, máximo 20)

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `itens` (array)
    Lista de documentos consultados

  - `itens.capturas` (array)
    Capturas geradas a partir do documento (vazio se não houver)

  - `itens.capturas.id_captura` (string)
    ID da captura
    Example: abcdef12-3456-7890-abcd-ef1234567890

  - `itens.capturas.status_captura` (string)
    Status da captura
    Enum: "PROCESSANDO", "PENDENTE", "ACEITA", "REJEITADA", "FALHA"

  - `itens.id_documento` (string)
    ID do documento
    Example: 1234abcd-5678-90ef-1234-567890abcdef

  - `itens.status_documento` (string)
    Status do processamento do documento
    Enum: "PENDENTE", "PROCESSANDO", "EXTRAINDO_DADOS", "APLICANDO_REGRAS", "AGUARDANDO_VINCULO_LANCAMENTO", "CRIANDO_LANCAMENTOS_FINANCEIROS", "PRONTO", "IGNORADO", "RESOLVIDO", "ERRO", "EXCLUIDO"

  - `paginacao` (object)
    Dados de paginação

  - `paginacao.pagina_atual` (integer)
    Página atual
    Example: 1

  - `paginacao.tamanho_pagina` (integer)
    Tamanho da página
    Example: 20

  - `paginacao.total_itens` (integer)
    Total de documentos encontrados
    Example: 1

  - `paginacao.total_paginas` (integer)
    Total de páginas
    Example: 1

## Response 400:

  - `400` (unknown)
    Requisição inválida — dados de entrada incorretos (ex.: ids vazio, UUID inválido ou tamanho_pagina acima de 20)

## Response 400 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: Mensagem de erro detalhada

## Response 401:

  - `401` (unknown)
    Não autenticado — token de acesso ausente ou inválido

## Response 401 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: Mensagem de erro detalhada

## Response 500:

  - `500` (unknown)
    Erro interno ao consultar o status no serviço da Captura

## Response 500 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: Mensagem de erro detalhada