GET
/
consultas
/
resultado
/
{consultaId}
Verificar resultado
curl --request GET \
  --url https://api.sollosconsultas.com.br/consultas/resultado/{consultaId} \
  --header 'x-access-token: <api-key>'
{
  "status": "completed",
  "query_execution": 4201,
  "data_execucao": "10/04/2026 14:32:00",
  "resultados": {
    "nome": "JOÃO DA SILVA",
    "cpf": "123.456.789-00",
    "situacao_receita": "REGULAR",
    "data_nascimento": "1985-03-22",
    "emails": [
      "joao@email.com"
    ],
    "telefones": [
      "(11) 98765-4321"
    ]
  }
}

​
Estados da execução

Campo statusHTTPO que significa
pending202A consulta está na fila ou sendo processado pelo provedor
completed200Resultado disponível no campo resultados
failed500O provedor retornou um erro após todas as tentativas

​
O que fazer com cada estado

Aguarde 2 segundos e repita a requisição. A maioria das consultas conclui em 1 a 3 segundos. Implemente um limite máximo de tentativas (recomendamos 15) para evitar loops infinitos.
O campo resultados contém a resposta completa do provedor. Salve também o query_execution — ele é o ID permanente desta execução e pode ser usado em GET /consultas/logs/details/{id} para recuperar o resultado futuramente.
O provedor não conseguiu responder após todas as tentativas de retry e failover. O campo error descreve a causa. Neste caso, a execução ainda é registrada no histórico, mas o campo status no log será failed.

​
Disponibilidade do resultado

O resultado fica disponível neste endpoint por 1 hora após a conclusão. Após esse período, use: 
GET /consultas/logs/details/{query_execution}
Onde {query_execution} é o ID retornado no campo query_execution da resposta completed.
Para não perder o resultado, salve o query_execution junto com os dados retornados assim que receber o status completed.

Authorizations

​
x-access-token
string
header
required

Token JWT retornado pelo endpoint POST /auth/login. Inclua este header em todas as requisições autenticadas.

Path Parameters

​
consultaId
string
required

O consultaId retornado pelo endpoint de execução

Response

Execução concluída. O campo resultados contém a resposta completa do provedor.

​
status
enum<string>
Available options:
completed
Example:

"completed"

​
query_execution
integer

ID do registro permanente desta execução. Use em GET /consultas/logs/details/{id} para recuperar o resultado futuramente.

Example:

4201

​
data_execucao
string

Data e hora da execução no fuso de Brasília

Example:

"10/04/2026 14:32:00"

​
resultados
object

Dados retornados pelo provedor. A estrutura varia de acordo com o tipo de consulta executada.