Consultar detalhes da solicitação

atenção

Em desenvolvimento - ainda não disponível em produção

Retorna a situação de uma solicitação com o prazo e os andamentos, no formato adequado para informar o munícipe (por exemplo, em atendimento telefônico).

dica

O protocolo de uma solicitação é o próprio ID, com os 0 iniciais. Para consultar pelo protocolo informado pelo munícipe, basta usá-lo como idSolicitacao.

Endpoints

Método	URL
GET	https://{{url}}/cube/api/v3/solicitacoes/{{idSolicitacao}}/detalhes

Respostas

Exemplo de corpo da resposta

{
    "id": 1234567,
    "protocolo": "1234567",
    "status": "EM_ANDAMENTO",
    "dataCadastro": "2026-10-30T14:12:05.000Z",
    "dataLimite": "2026-11-06T14:12:05.000Z",
    "prazoUltrapassado": false,
    "tempoRestante": {
        "dias": 3,
        "horas": 4,
        "minutos": 20
    },
    "orgao": "Iluminação Pública",
    "tipoSolicitacao": "Lâmpada apagada",
    "andamentos": [
        {
            "data": "2026-10-31T09:00:00.000Z",
            "status": "EM_ANDAMENTO",
            "resposta": "<p>Equipe agendada para vistoria.</p>"
        }
    ]
}

Chave	Descrição
id	ID da solicitação
protocolo	Protocolo da solicitação
status	Status atual: ABERTA, EM_ANDAMENTO, FINALIZADA, AGUARDANDO_APROVACAO, CANCELADA, RELACIONADA ou SPAM
dataCadastro	Data de abertura
dataLimite	Prazo para conclusão
prazoUltrapassado	true quando a data limite já passou (ou, para solicitações encerradas, quando foram encerradas depois dela)
tempoRestante	Tempo até a data limite em dias, horas e minutos. Não aparece quando a solicitação está encerrada, sem data limite ou com prazo ultrapassado
orgao	Órgão atual de tratamento
tipoSolicitacao	Nome do tipo solicitação
andamentos[].data	Data do andamento
andamentos[].status	Status registrado no andamento
andamentos[].resposta	Texto do andamento, em HTML

Status da resposta

Status	Descrição
200	OK - Retorna os detalhes da solicitação.
401	API Key, Secret ou Client ID inválidos.
429	Limite de requisições excedido.

Permissões necessárias

Permissão	Descrição
resolucao:solicitacoes:visualizar	Permite que solicitações sejam visualizadas via API