Consulta o protocolo de um rastreamento veicular

Devolve o estado da consulta e, quando concluída, o resultado. Responde 200 nos quatro estados — inclusive quando a consulta falhou: o recurso de protocolo existe, e o desfecho vem no campo status.

Estados: pending (em processamento), done (concluída, com data), error (o provedor encerrou sem resultado) e expired (não concluiu dentro do prazo de expiresAt).

Consultar o protocolo é gratuito — pode ser repetido à vontade. O resultado fica disponível por 30 dias; depois disso a consulta segue done, mas data vem null.

GET /api/v1/consultas/rastreamento-veicular/{id}

Consulta o protocolo de um rastreamento veicular

cURL

curl --request GET \
  --url https://api.jusfy.dev/calculators/api/v1/consultas/rastreamento-veicular/{id} \
  --header 'x-api-key: <api-key>'

200

Example

{
  "statusCode": 200,
  "message": "Consulta localizada",
  "timestamp": "2026-09-02T18:05:00.000Z",
  "path": "/api/v1/consultas/rastreamento-veicular/aqry_1f0b2c3d-4e5f-6071-8293-a4b5c6d7e8f9",
  "result": {
    "id": "aqry_1f0b2c3d-4e5f-6071-8293-a4b5c6d7e8f9",
    "consulta": "rastreamento-veicular",
    "status": "done",
    "createdAt": "2026-09-02T18:00:00.000Z",
    "updatedAt": "2026-09-02T18:04:12.000Z",
    "expiresAt": "2026-09-02T18:10:00.000Z",
    "completedAt": "2026-09-02T18:04:12.000Z",
    "data": {
      "capturesCount": 3,
      "statesAbbreviationCaptures": [
        "SP"
      ],
      "statesAndCitiesCaptures": [
        {
          "state": "São Paulo",
          "totalCount": 3,
          "cities": [
            {
              "city": "SAO PAULO",
              "count": 2
            },
            {
              "city": "CAMPINAS",
              "count": 1
            }
          ]
        }
      ],
      "listCaptures": [
        {
          "urlImage": "https://api.jusfy.dev/calculators/api/v1/consultas/rastreamento-veicular/aqry_7c2e1a90-3b4d-5e6f-8a91-b2c3d4e5f607/capturas/0/imagem",
          "captureDate": "2026-05-02T10:14:33Z",
          "street": "AV PAULISTA",
          "city": "SAO PAULO",
          "state": "SP",
          "plate": "ABC1D23"
        },
        {
          "urlImage": "https://api.jusfy.dev/calculators/api/v1/consultas/rastreamento-veicular/aqry_7c2e1a90-3b4d-5e6f-8a91-b2c3d4e5f607/capturas/1/imagem",
          "captureDate": "2026-05-07T18:02:11Z",
          "street": "MARGINAL TIETE",
          "city": "SAO PAULO",
          "state": "SP",
          "plate": "ABC1D23"
        },
        {
          "urlImage": "https://api.jusfy.dev/calculators/api/v1/consultas/rastreamento-veicular/aqry_7c2e1a90-3b4d-5e6f-8a91-b2c3d4e5f607/capturas/2/imagem",
          "captureDate": "2026-06-11T07:45:02Z",
          "street": "ROD DOM PEDRO I",
          "city": "CAMPINAS",
          "state": "SP",
          "plate": "ABC1D23"
        }
      ],
      "capturesCoordinate": [
        [
          "-46.6558",
          "-23.5614"
        ],
        [
          "-46.7031",
          "-23.5189"
        ],
        [
          "-47.0616",
          "-22.9056"
        ]
      ],
      "createdAt": "2026-06-11T07:45:02.000Z"
    }
  }
}

Autorizações

x-api-key · string · header · obrigatório

Parâmetros de caminho

id · string · obrigatório

O id devolvido no 202 do disparo.

Exemplo:

"aqry_1f0b2c3d-4e5f-6071-8293-a4b5c6d7e8f9"

Resposta

200

application/json

Estado atual da consulta. data só aparece em done; error, em error/expired.

The response is of type object.