Receita Federal · Documentação oficial

Situação da Solicitação

Consulta a situação do processamento de uma solicitação assíncrona via tiqueteSolicitacao.

docs.receitafederal.gov.br/apuracao-cbs/ Versão 1.1 · set/2026 · Receita Federal do Brasil

Endpoints

GET https://api.receitafederal.gov.br/apuracao-cbs-prr/v2/situacao/{tiqueteSolicitacao} produção restrita

GET https://api.receitafederal.gov.br/apuracao-cbs/v2/situacao/{tiqueteSolicitacao} produção

Exemplo de chamada

curl --location --request GET \
  'https://api.receitafederal.gov.br/apuracao-cbs-prr/v2/situacao/{tiqueteSolicitacao}' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Accept: application/json'

Campos de retorno

Campo	Formato	Descrição
`estado`	String	`PENDENTE`, `EM_PROCESSAMENTO`, `CONCLUIDA` ou `ERRO`
`urlAssinada`	String	URL pré-assinada — disponível quando `estado = CONCLUIDA`
`urlAssinadaExpiraEm`	datetime	Data/hora de expiração — disponível quando `estado = CONCLUIDA`
`codigoErro`	String	Código técnico do erro — disponível quando `estado = ERRO`
`mensagemErro`	String	Descrição legível do erro — disponível quando `estado = ERRO`

Estados possíveis

PENDENTE

Na fila, aguardando início do processamento.

EM_PROCESSAMENTO

Em processamento. Tempo máximo: 240 minutos.

CONCLUIDA

Processamento concluído. Campo urlAssinada disponível por 48 horas.

ERRO

Falha no processamento. Consultar codigoErro e mensagemErro.

Exemplos de resposta

HTTP 200 — Solicitação concluída

{
  "estado": "CONCLUIDA",
  "urlAssinada": "https://api.receitafederal.gov.br/...",
  "urlAssinadaExpiraEm": "2026-08-26T14:30:00Z"
}

HTTP 400/401/404/500 — Erro

{
  "estado": "ERRO",
  "codigoErro": "APURACAO-408",
  "mensagemErro": "Tempo limite de processamento excedido (240 minutos)."
}