> ## 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. # Consulta de Status da entrega > Consulta o status de uma ou mais entregas. **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](/api-reference/entregas/unfinished-status-reasons). ## Rate limit Este endpoint tem o limite: * 1 requisições a cada 30 segundos. ## OpenAPI ````yaml POST /v2/getOrderStatus openapi: 3.1.0 info: title: API Pública description: >- API da Husky, teste uma plataforma de logística para delivery e entregas. Aqui você encontra todas as informações necessárias para integrar o sistema Husky em seu aplicativo ou sistema. version: 0.0.1 servers: - url: https://sandbox.api.gohusky.net description: Ambiente de Homologação, use para testes e desenvolvimento. - url: https://api.gohusky.net description: Ambiente de Produção, use para produção. security: [] paths: /v2/getOrderStatus: post: tags: - Entregas summary: Consulta de Status da entrega description: Consulta o status de uma ou mais entregas. operationId: v2/getOrderStatus parameters: - $ref: '#/components/parameters/live_mode' requestBody: content: application/json: schema: type: object required: - tracking_codes properties: tracking_codes: description: Array de identificadores de entregas type: array items: type: string example: - >- 051aa70b607f97beeba3f5f9ee2a6b984a9f1489c3a74d6083afc59e1685cb2a - >- a2bc5861e95cfa3806d47a3c9841f9a489b6a2ee9f5f3abeeb79f706b07aa150 responses: '200': description: Consulta realizada com sucesso content: application/json: schema: type: object properties: success: type: integer description: Código de status da resposta. 1 = Sucesso example: 1 message: description: Mensagem de retorno da requisição type: string example: Requisição realizada com sucesso. found: description: Trackings encontrados type: object properties: '[TRACKING_CODE]': description: Identificador da entrega type: object properties: orderId: description: Número da entrega na operação type: string example: '1' status: description: Status da entrega type: string example: Não Finalizado updatedAt: description: Data de atualização da entrega type: string example: '2025-01-28 16:37:43' reason: description: Código do motivo de Não Finalização da entrega type: integer example: 5 fleet: description: Informações do entregador type: object properties: id: description: Identificador do entregador type: integer example: 2033 name: description: Nome do entregador type: string example: Fulano de Tal status_history: description: Histórico de status da entrega type: array items: type: object properties: status: description: Status da entrega type: string example: Em Aberto timestamp: description: Data de atualização do status da entrega type: string example: '2025-01-27 13:11:45' latitude: description: >- Coordenada de latitude da alteração de status da entrega type: number example: 123.123123 longitude: description: >- Coordenada de longitude da alteração de status da entrega type: number example: 123.123123 origin: description: >- **ATENÇÃO:** Este campo estará presente somente no status `Finalizado` e somente quando a entrega tiver confirmação por PIN Code. Origem da alteração de status da entrega. **Possíveis valores:** - `Aplicativo do entregador` = Alteração de status feita pelo entregador via aplicativo. - `Operador Logístico` = Alteração de status feita pelo operador logístico (empresa de entregas). - `Embarcador` = Alteração de status feita pelo embarcador (lojista/restaurante). type: string example: Aplicativo do entregador pincode: description: >- **ATENÇÃO:** Este campo estará presente somente no status `Finalizado` e somente quando a entrega tiver confirmação por PIN Code. Informações do PIN Code type: object properties: confirmed: description: Indica se o PIN Code foi confirmado type: boolean example: true timestamp: description: >- Data e hora (UTC) da tentativa de confirmação do PIN Code type: string example: '2026-02-11 18:44:36' latitude: description: >- Coordenada de latitude da tentativa de confirmação do PIN Code type: number example: 123.123123 longitude: description: >- Coordenada de longitude da tentativa de confirmação do PIN Code type: number example: 123.123123 attempts: description: >- Quantidade de tentativas de confirmação do PIN Code type: integer example: 3 attachments: type: array items: type: object properties: type: type: enum enum: - photo - signature example: photo description: >- Tipo de anexo. `photo` = Foto evidência da entrega, `signature` = Assinatura do cliente fileUrl: description: URL do anexo type: string example: >- https://example.s3.sa-east-1.amazonaws.com/example.jpg 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: description: Trackings não encontrados type: array items: description: Identificador da entrega não encontrado type: string example: >- 051aa70b607f97beeba3f5f9ee2a6b984a9f1489c3a74d6083afc59e1685cb2a '400': description: Erro na consulta content: application/json: schema: type: array items: type: object properties: status: description: Código de status da resposta type: integer example: 0 message: description: Mensagem de retorno do erro type: string example: O campo 'tracking_codes' não foi informado '401': $ref: '#/components/responses/401' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '429': description: Limite de requisições atingido security: - TokenHeader: [] components: parameters: live_mode: name: live_mode in: query description: Especifica o ambiente para executar a requisição. required: true schema: type: boolean responses: '401': description: Token inválido ou não autorizado content: application/json: schema: type: object properties: success: type: integer example: 0 message: type: string example: Token inválido ou não autorizado '404': description: Token não informado corretamente content: application/json: schema: type: object properties: success: type: integer example: 0 message: type: string example: Token não informado corretamente '405': description: Método não permitido content: application/json: schema: type: object properties: success: type: integer example: 0 message: type: string example: Método não permitido, consulte a documentação. securitySchemes: TokenHeader: type: apiKey description: >- Token de autenticação via header. Utilizado exclusivamente para endpoints v2. Deve ser o token do embarcador. name: Token in: header ````