---
title: "Consultar detalhes do pedido"
method: GET
path: "/partners/api/v4/orders/{id}"
tags: ["Pedidos"]
---

# Consultar detalhes do pedido

`GET /partners/api/v4/orders/{id}`

## Request

- Base URL: `https://platform-bff-partners.stg.clickbus.net`
- URL: `https://platform-bff-partners.stg.clickbus.net/partners/api/v4/orders/{id}`
- Auth: HTTP bearer

Consulta detalhes de um pedido específico por ID. Retorna informações completas sobre o pedido, incluindo dados do cliente, itens, pagamentos e status. Requer autenticação por email ou documento para validação de acesso. É obrigatório fornecer pelo menos um dos parâmetros: email ou documentNumber.

## Path parameters

- `publicId` string, required

## Query parameters

- `email` string
- `documentNumber` string

## Response `200`

Detalhes do pedido solicitado

- OrderDto: Resumo de um pedido com informações de tickets e pagamentos
  - `publicId` string, required: Identificador público único do pedido. Código alfanumérico de 8 caracteres usado para referência em todas as operações (consulta individual, cancelamento, etc).
  - `status` 'pending' | 'completed' | 'canceled' | 'partially_canceled' | 'incomplete', required: Status atual do pedido. Reflete o estado consolidado da ordem. 'pending' = aguardando processamento do pagamento; 'completed' = pagamento confirmado e tickets emitidos; 'canceled' = pedido totalmente cancelado (todos os itens); 'partially_canceled' = alguns itens cancelados, outros ativos; 'incomplete' = falha no pagamento ou timeout.
  - `createdAt` string, required: Data e hora de criação do pedido no formato ISO 8601. Representa o momento em que o checkout foi iniciado.
  - `totalAmount` number, double, required: Valor total pago pelo pedido em reais (BRL). Inclui tickets, taxas de serviço e seguros. Não inclui descontos já subtraídos. Para pedidos parcialmente cancelados, reflete o valor original (não o valor residual).
  - `currency` 'BRL', required: Código da moeda no padrão ISO 4217. Atualmente sempre 'BRL' para operações Brasil.
  - `clientApplication` ClientApplicationDTO, required: Identificação da aplicação/canal que originou o pedido
    - `id` number, required: ID interno da aplicação cliente. Usado para identificar o canal de venda (ex: 2 = BR Web Desktop, 5 = Partner App, etc).
    - `name` string, required: Nome legível da aplicação cliente
  - `customer` CustomerDTO, required: Dados resumidos do cliente/comprador
    - `email` string, required: Endereço de email do cliente que realizou a compra
    - `activeUser` boolean, required: Indica se o cliente possui cadastro ativo na plataforma ClickBus. false = comprador avulso (guest checkout).
  - `directionNextTrip` string, nullable, required: Direção da próxima viagem quando aplicável (usado internamente para ordenação de próximos embarques). Geralmente null na resposta de listagem.
  - `tickets` TicketsDTO, required: Estrutura contendo tickets de ida (departure) e volta (return). Para viagens somente ida, o campo 'return' será null.
    - `departure` TicketDTO, required: Informações detalhadas de um trecho (ida ou volta)
      - `origin` string, required: Nome completo do ponto de embarque no formato "Cidade, UF - Terminal". Pode variar de acordo com o terminal (ex: "Sao Paulo, SP - Tiete" vs "Sao Paulo, SP - Barra Funda").
      - `destination` string, required: Nome completo do ponto de desembarque no formato "Cidade, UF" ou "Cidade, UF - Terminal".
      - `originSlug` string, required: Slug identificador da origem. Usado para construção de URLs e deep links. Formato: cidade-estado ou cidade-terminal-estado.
      - `destinationSlug` string, required: Slug identificador do destino. Mesmo formato do originSlug.
      - `travelCompany` string, required: Nome da companhia rodoviária que opera o trecho.
      - `departureDate` string, required: Data e hora de partida no formato ISO 8601 (sem timezone - considera horário local do embarque). Formato: YYYY-MM-DDTHH:mm:ss
      - `arrivalDate` string, required: Data e hora estimada de chegada no formato ISO 8601 (sem timezone - considera horário local do destino). Formato: YYYY-MM-DDTHH:mm:ss
      - `passengerNames` string[], required: Nomes completos dos passageiros deste trecho. Um pedido pode ter múltiplos passageiros (ex: família viajando junta). A ordem dos nomes corresponde à ordem de cadastro no checkout.
    - `return` TicketDTO, required: Informações detalhadas de um trecho (ida ou volta)
      - `origin` string, required: Nome completo do ponto de embarque no formato "Cidade, UF - Terminal". Pode variar de acordo com o terminal (ex: "Sao Paulo, SP - Tiete" vs "Sao Paulo, SP - Barra Funda").
      - `destination` string, required: Nome completo do ponto de desembarque no formato "Cidade, UF" ou "Cidade, UF - Terminal".
      - `originSlug` string, required: Slug identificador da origem. Usado para construção de URLs e deep links. Formato: cidade-estado ou cidade-terminal-estado.
      - `destinationSlug` string, required: Slug identificador do destino. Mesmo formato do originSlug.
      - `travelCompany` string, required: Nome da companhia rodoviária que opera o trecho.
      - `departureDate` string, required: Data e hora de partida no formato ISO 8601 (sem timezone - considera horário local do embarque). Formato: YYYY-MM-DDTHH:mm:ss
      - `arrivalDate` string, required: Data e hora estimada de chegada no formato ISO 8601 (sem timezone - considera horário local do destino). Formato: YYYY-MM-DDTHH:mm:ss
      - `passengerNames` string[], required: Nomes completos dos passageiros deste trecho. Um pedido pode ter múltiplos passageiros (ex: família viajando junta). A ordem dos nomes corresponde à ordem de cadastro no checkout.
  - `payments` PaymentDTO[], required: Lista de pagamentos associados ao pedido. Um pedido pode ter múltiplos pagamentos quando há split (ex: parte cartão + parte voucher) ou reprocessamento.
    - `paymentGateway` 'mercadoPago' | 'paymee' | 'nuPay' | 'tuna', required: Gateway de pagamento utilizado para processar a transação. Valores possíveis: mercadoPago, paymee, nuPay, tuna.
    - `paymentType` 'credit_card' | 'debit_card' | 'pix' | 'pix_installment' | 'wallet', required: Método de pagamento escolhido pelo cliente. 'credit_card' = cartão de crédito (com ou sem parcelamento); 'debit_card' = cartão de débito; 'pix' = transferência instantânea PIX; 'pix_installment' = PIX parcelado; 'wallet' = saldo em carteira ClickBus.

## Other responses

- `400`: Requisição inválida
- `401`: Não autorizado - token inválido ou expirado
- `403`: Acesso negado - email ou documento não correspondem
- `404`: Pedido não encontrado
- `500`: Erro interno do servidor

---

[API](https://skmtc.dev/clickbus/apis/documenta-o-da-api-de-autentica-o-clickbus.md) - [All operations](https://skmtc.dev/clickbus/apis/documenta-o-da-api-de-autentica-o-clickbus/llms.txt) - [OpenAPI document](https://skmtc.dev/clickbus/apis/documenta-o-da-api-de-autentica-o-clickbus/revisions/ead7d81fdb28?raw)
