# Consultar venda

URL: https://staging.pagpolar.com/docs/referencia/vendas/get-sale

> Aceita três formas de referência, testadas nesta ordem: o `id` da venda (uuid, o mesmo que volta em `transactions` na criação do pagamento), o código da venda e a `external_reference` que você enviou no pedido. O valor só é tratado como código quando tem o formato do código: 10 dígitos, com ou sem o prefixo (ex.: `PPO0087103960`), ou um link terminado nele. Se a mesma `external_reference` foi usada em mais de um pedido, volta a venda mais recente.

`GET /sales/{identifier}`

## 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 | Id (uuid), código ou referência externa da venda. |

## Respostas

### 200 — Venda

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `data` | [Venda](/docs/referencia/entidades/venda) | não | — |

## Erros

| Status | Descrição |
| --- | --- |
| `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` | Venda não encontrada |
| `429` | Limite de requisições excedido |

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