<!-- Generated from https://developers.superfrete.com/openapi.yaml (operationId: getOrder). -->

# Consultar pedido

> `GET /api/v0/order/info/{id}` · Referência interativa: https://developers.superfrete.com/referencia#getOrder

- **Method:** `GET`
- **Path:** `/api/v0/order/info/{id}`
- **Operation ID:** `getOrder`
- **Tags:** Pedidos

Devolve os dados de um pedido pelo ID: remetente, destinatário, caixa, preço, status, rastreio e link de impressão.

- `tracking` fica vazio até o pagamento e a geração da etiqueta.
- `print.url` é o PDF da etiqueta. Ele só tem conteúdo enquanto a etiqueta está paga e aguardando postagem.
- `service_id` só vem preenchido para PAC (`1`) e SEDEX (`2`). Para saber o serviço dos outros pedidos, use a [listagem de pedidos](https://developers.superfrete.com/referencia/md/listOrders.md).
- `generated_at` e `posted_at` só aparecem depois que a etiqueta é gerada e postada.

## Effective servers

- `https://sandbox.superfrete.com`

  Sandbox (testes, etiquetas sem validade)
- `https://api.superfrete.com`

  Produção

## Authentication

- **bearerAuth**: HTTP bearer (`JWT`)

  Token de acesso da SuperFrete, no header `Authorization: Bearer {token}`.
  - **Integração da própria loja:** gere o token no painel, em **Integrações** ([produção](https://web.superfrete.com/#/integrations) ou [sandbox](https://sandbox.superfrete.com/#/integrations)).
  - **Plataforma que conecta várias contas:** obtenha um token por seller com o fluxo OAuth 2.0 ([`exchangeOAuthToken`](https://developers.superfrete.com/referencia/md/exchangeOAuthToken.md)).

  O token não expira e dá acesso a todas as rotas da API para a conta; não há escopos. Ele deixa de valer quando a integração é removida no painel. O token de sandbox só funciona no sandbox, e o de produção só em produção.

## Path parameters

- **`id` (required)**: `string`

  ID do pedido na SuperFrete.

  **Example:**

  ```json
  "r8p3dhqjn4I0tBpnvkpU"
  ```

## Header parameters

- **`User-Agent` (required)**: `string`

  Nome da sua aplicação com um e-mail de contato técnico, no formato `Aplicação (email@exemplo.com)`. Hoje só [Listar pedidos](https://developers.superfrete.com/referencia/md/listOrders.md) recusa um valor fora desse formato, mas envie em todas as rotas.

  **Example:**

  ```json
  "MinhaLoja (dev@minhaloja.com.br)"
  ```

## Responses

### 200 Dados do pedido.

**Content type:** `application/json`

schema: `Order`

- **`created_at`**: `string`, format: `date-time`
- **`delivery`**: `integer`

  Prazo de entrega informado na cotação, em dias úteis.
- **`delivery_max`**: `integer`
- **`delivery_min`**: `integer`
- **`discount`**: `number`

  Desconto em relação ao preço de balcão, em reais.
- **`format`**: `string`, possible values: `"box"`
- **`from`**: `object`, schema: `OrderAddress`
  - **`address`**: `string`
  - **`city`**: `string`
  - **`complement`**: `string | null`
  - **`country_id`**: `string`, possible values: `"BR"`
  - **`district`**: `string`
  - **`document`**: `string | null`

    CPF ou CNPJ.
  - **`email`**: `string | null`
  - **`location_number`**: `string`

    Número do endereço.
  - **`name`**: `string`
  - **`phone`**: `string | null`
  - **`postal_code`**: `string`
  - **`state_abbr`**: `string`
- **`generated_at`**: `string`, format: `date-time`

  Quando a etiqueta foi gerada. Ausente antes disso.
- **`height`**: `string`

  Altura da caixa, em cm.
- **`id`**: `string`

  ID do pedido.
- **`insurance_value`**: `string | number | null`

  Valor segurado, em reais.
- **`invoice`**: `string | null`

  Chave de acesso da nota fiscal, ou `null` quando a etiqueta usa declaração de conteúdo.
- **`length`**: `string`

  Comprimento da caixa, em cm.
- **`own_hand`**: `boolean`
- **`posted_at`**: `string`, format: `date-time`

  Quando a encomenda foi postada. Ausente antes disso.
- **`price`**: `number`

  Preço pago, em reais.
- **`print`**: `object`
  - **`url`**: `string`, format: `uri`

    PDF da etiqueta.
- **`products`**: `array`

  Itens da declaração de conteúdo. Os valores vêm como texto.

  **Items:**
  - **`name`**: `string`
  - **`quantity`**: `string`
  - **`unitary_value`**: `string`
- **`protocol`**: `string`

  Igual a `id`.
- **`receipt`**: `boolean`
- **`service_calculated`**: `object`

  Detalhes internos do cálculo do frete. Podem mudar sem aviso; não dependa deles.
- **`service_id`**: `integer`, possible values: `1, 2`

  `1` PAC ou `2` SEDEX. Ausente para os outros serviços.
- **`service_posted`**: `any`

  Detalhes internos da postagem. Podem mudar sem aviso; não dependa deles.
- **`status`**: `string`, possible values: `"pending", "released", "posted", "delivered", "canceled"`

  `pending`: aguardando pagamento · `released`: paga, aguardando postagem · `posted`: postada · `delivered`: entregue · `canceled`: cancelada.
- **`tags`**: `array`, schema: `OrderTags`

  Identificação do pedido na sua plataforma, enviada em `options.tags`.

  **Items:**
  - **`tag`**: `string`
  - **`url`**: `string`
- **`to`**: `object`, schema: `OrderAddress`

  *Schema `OrderAddress` is shown above.*
- **`tracking`**: `string`

  Código de rastreio. Vazio até a etiqueta ser gerada.
- **`updated_at`**: `string`, format: `date-time`
- **`weight`**: `string`

  Peso da caixa, em kg.
- **`width`**: `string`

  Largura da caixa, em cm.

**Example:**

```json
{
  "id": "r8p3dhqjn4I0tBpnvkpU",
  "protocol": "r8p3dhqjn4I0tBpnvkpU",
  "format": "box",
  "delivery": 5,
  "delivery_min": 5,
  "delivery_max": 5,
  "discount": 7.41,
  "height": "4",
  "width": "16",
  "length": "24",
  "weight": "0.6",
  "from": {
    "address": "Rua Barão de Itapetininga",
    "city": "São Paulo",
    "complement": "Sala 12",
    "district": "República",
    "document": "11222333000181",
    "name": "Loja Aurora",
    "location_number": "255",
    "phone": "11912345678",
    "postal_code": "01042001",
    "state_abbr": "SP",
    "country_id": "BR"
  },
  "to": {
    "address": "Avenida Rio Branco",
    "city": "Rio de Janeiro",
    "complement": null,
    "email": "mariana.souza@example.com",
    "district": "Centro",
    "document": "52998224725",
    "name": "Mariana Souza",
    "location_number": "156",
    "phone": "21987654321",
    "postal_code": "20040003",
    "state_abbr": "RJ",
    "country_id": "BR"
  },
  "invoice": null,
  "own_hand": false,
  "receipt": false,
  "price": 22.38,
  "tracking": "AA123456785BR",
  "status": "released",
  "service_id": 1,
  "products": [
    {
      "name": "Camiseta básica",
      "quantity": "2",
      "unitary_value": "49.9"
    }
  ],
  "insurance_value": "99.8",
  "generated_at": "2026-10-29T14:03:12.511Z",
  "created_at": "2026-10-29T14:01:47.399Z",
  "updated_at": "2026-10-29T14:03:12.902Z",
  "print": {
    "url": "https://etiqueta.superfrete.com/_etiqueta/pdf/Jx8kq2LmN4pR7sT1vW3y?format=A4"
  },
  "tags": [
    {
      "tag": "3101481",
      "url": "https://minhaloja.com.br/pedidos/3101481"
    }
  ]
}
```

### 400 Pedido não encontrado.

**Content type:** `application/json`

schema: `ValidationError`

Um ou mais campos da requisição são inválidos.

- **`errors` (required)**: `object`

  Mapa do campo (ex.: `to.postal_code`) para a lista de mensagens de erro desse campo.

  **Additional properties:**

  `array of string`
- **`message` (required)**: `string`

  Sempre `Ocorreu um ou mais erros.`

**Example:**

```json
{
  "message": "Ocorreu um ou mais erros.",
  "errors": {
    "orders.0": [
      "Pedido não encontrado."
    ]
  }
}
```

### 401 Token ausente, inválido, removido ou de outro ambiente.

**Content type:** `application/json`

schema: `Error`

Erro de regra de negócio ou de autenticação. `message` e `error` trazem o mesmo texto.

- **`error` (required)**: `string`

  Mesmo conteúdo de `message`, mantido por compatibilidade.
- **`message` (required)**: `string`

  Mensagem legível do erro.

**Example:**

```json
{
  "message": "Token inválida!",
  "error": "Token inválida!"
}
```

### 500 Erro interno. O corpo pode ser um objeto de erro ou só um texto JSON com a mensagem.

**Content type:** `application/json`

**One of:**

- *Schema `Error` is shown above.*
- `string`

**Example:**

```json
{
  "message": "",
  "error": ""
}
```

## Schemas

- `Error` — shown above.
- `ValidationError` — shown above.

### OrderStatus

**Type:** `string`, possible values: `"pending", "released", "posted", "delivered", "canceled"`

`pending`: aguardando pagamento · `released`: paga, aguardando postagem · `posted`: postada · `delivered`: entregue · `canceled`: cancelada.

- `OrderTags` — shown above.
- `OrderAddress` — shown above.
- `Order` — shown above.