# Consultar o frete de uma oferta

URL: https://staging.pagpolar.com/docs/referencia/ofertas/list-offer-shipping

> Devolve as opções de entrega de uma oferta de produto físico para um CEP. Use o `id` da opção escolhida em `shipping_option_id` na criação do pagamento.

Pré-requisito, feito pelo vendedor no painel: a integração de logística cadastrada, as dimensões e o peso do produto preenchidos e pelo menos uma configuração de frete ativa. Sem configuração de frete, a consulta responde `400`.

Oferta que não é de produto físico responde `200` com a lista vazia. Se a transportadora não responder, as opções de frete calculado ficam de fora e as opções grátis e de valor fixo continuam na lista.

`GET /offers/{identifier}/shipping`

## Autenticação

- Token Bearer no header `Authorization` (esquema `BearerAuth`). Token de acesso devolvido por POST /auth/token. Envie como "Authorization: Bearer <token>". Vale 24 horas.

## Parâmetros de caminho

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `identifier` | texto | sim | Exemplo: `PPP1234567890`. |

## Parâmetros de consulta

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `postal_code` | texto | sim | CEP de destino, com ou sem pontuação. Exemplo: `01311000`. |
| `quantity` | inteiro | não | Quantidade de unidades, para o cálculo do peso. O padrão é 1. Exemplo: `1`. |

## Respostas

### 200 — Opções de frete

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `data` | [lista de Opção de frete](/docs/referencia/entidades/opcao-de-frete) | não | — |

## Erros

| Status | Descrição |
| --- | --- |
| `400` | CEP inválido, ou produto físico sem configuração de frete ativa |
| `401` | Token ausente, inválido ou expirado, ou credencial revogada ou expirada. Chame POST /auth/token para obter um token novo. |
| `403` | IP não autorizado |
| `404` | Oferta não encontrada |
| `429` | Limite de requisições excedido |

Lista completa de códigos e como tratá-los: [Erros](/docs/guias/fundamentos/erros).
