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",
      "a2bc5861e95cfa3806d47a3c9841f9a489b6a2ee9f5f3abeeb79f706b07aa150"
    ]
  ]
}
'
{
  "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
          }
        }
      ],
      "attachments": [
        {
          "type": "photo",
          "fileUrl": "https://example.s3.sa-east-1.amazonaws.com/example.jpg"
        },
        {
          "type": "signature",
          "fileUrl": "https://example.s3.sa-east-1.amazonaws.com/example.jpg"
        }
      ]
    }
  },
  "notFound": [
    "051aa70b607f97beeba3f5f9ee2a6b984a9f1489c3a74d6083afc59e1685cb2a"
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.gohusky.net/llms.txt

Use this file to discover all available pages before exploring further.

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
        }
      }
    ],
    "attachments": [
      {
        "type": "photo",
        "fileUrl": "https://example.s3.sa-east-1.amazonaws.com/example.jpg"
      },
      {
        "type": "signature",
        "fileUrl": "https://example.s3.sa-east-1.amazonaws.com/example.jpg"
      }
    ]
  }
}
​
notFound
string[]

Trackings não encontrados

Identificador da entrega não encontrado