Skip to main content
POST
/
v2
/
getOrderStatus
Consulta de Status da entrega
curl --request POST \
  --url https://sandbox.api.gohusky.net/v2/getOrderStatus \
  --header 'Content-Type: application/json' \
  --header 'Token: <api-key>' \
  --data '
{
  "tracking_codes": [
    "051aa70b607f97beeba3f5f9ee2a6b984a9f1489c3a74d6083afc59e1685cb2a"
  ]
}
'
{
  "success": 1,
  "message": "Requisição realizada com sucesso.",
  "found": {
    "a2bc5861e95cfa3806d47a3c9841f9a489b6a2ee9f5f3abeeb79f706b07aa150": {
      "orderId": null,
      "status": "Finalizado",
      "updatedAt": "2026-02-11 18:42:11",
      "fleet": {
        "id": 2033,
        "name": "Fulano de Tal"
      },
      "status_history": [
        {
          "status": "Em Aberto",
          "timestamp": "2026-02-11 18:41:17",
          "latitude": null,
          "longitude": null
        },
        {
          "timestamp": "2026-02-11 18:42:11",
          "latitude": "-29.1234568",
          "longitude": "1.9876543",
          "status": "Finalizado",
          "origin": "Aplicativo do entregador",
          "pincode": {
            "confirmed": true,
            "timestamp": "2026-02-11 18:44:36",
            "latitude": "-29.1234568",
            "longitude": "1.9876543",
            "attempts": 3
          }
        }
      ]
    }
  },
  "notFound": [
    "051aa70b607f97beeba3f5f9ee2a6b984a9f1489c3a74d6083afc59e1685cb2a"
  ]
}
Por quanto tempo as entregas estão disponíveis para consulta? Entregas em aberto sempre estão disponiveis para consulta. Entregas finalizadas estão disponíveis em um range de 7 dias (3 dias antes da data atual e 3 dias após a data atual) da data de agendamento da entrega. Por exemplo: uma entrega finalizada e que havia sido agendada para a data 13/02/2025 só poderá ser consultada no endpoint até a data 16/02/2025.
O payload de resposta retorna o motivo de Não Finalizado na sua forma de código.O código segue os Motivos de Status Não Finalizado que podem ser obtidos no endpoint /unfinishedStatusReasons.

​
Rate limit

Este endpoint tem o limite:
  • 1 requisições a cada 30 segundos.

Authorizations

​
Token
string
header
required

Token de autenticação via header. Utilizado exclusivamente para endpoints v2. Deve ser o token do embarcador.

Query Parameters

​
live_mode
boolean
required

Especifica o ambiente para executar a requisição.

Body

application/json
​
tracking_codes
string[]
required

Array de identificadores de entregas

Response

Consulta realizada com sucesso

​
success
integer

Código de status da resposta. 1 = Sucesso

Example:

1

​
message
string

Mensagem de retorno da requisição

Example:

"Requisição realizada com sucesso."

​
found
object

Trackings encontrados

Example:
{
  "a2bc5861e95cfa3806d47a3c9841f9a489b6a2ee9f5f3abeeb79f706b07aa150": {
    "orderId": null,
    "status": "Finalizado",
    "updatedAt": "2026-02-11 18:42:11",
    "fleet": { "id": 2033, "name": "Fulano de Tal" },
    "status_history": [
      {
        "status": "Em Aberto",
        "timestamp": "2026-02-11 18:41:17",
        "latitude": null,
        "longitude": null
      },
      {
        "timestamp": "2026-02-11 18:42:11",
        "latitude": "-29.1234568",
        "longitude": "1.9876543",
        "status": "Finalizado",
        "origin": "Aplicativo do entregador",
        "pincode": {
          "confirmed": true,
          "timestamp": "2026-02-11 18:44:36",
          "latitude": "-29.1234568",
          "longitude": "1.9876543",
          "attempts": 3
        }
      }
    ]
  }
}
​
notFound
string[]

Trackings não encontrados

Identificador da entrega não encontrado