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

# Listar endereços

> `GET /api/v0/user/addresses` · Referência interativa: https://developers.superfrete.com/referencia#listUserAddresses

- **Method:** `GET`
- **Path:** `/api/v0/user/addresses`
- **Operation ID:** `listUserAddresses`
- **Tags:** Usuário

Devolve os endereços cadastrados em **Perfil > Meus Endereços**, dentro de `data`.

## 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.

## 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 Endereços da conta.

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

- **`data` (required)**: `array`

  **Items:**

  schema: `UserAddress`
  - **`address`**: `string`

    Logradouro.
  - **`city`**: `string`
  - **`complement`**: `string`
  - **`created_at`**: `string`, format: `date-time`
  - **`district`**: `string`
  - **`id`**: `string`
  - **`is_default`**: `boolean`

    Endereço principal da conta.
  - **`label`**: `string`

    Nome dado ao endereço.
  - **`latitude`**: `string`
  - **`longitude`**: `string`
  - **`number`**: `string`
  - **`postal_code`**: `string`
  - **`state`**: `string`

    UF.
  - **`uid`**: `string`

    ID da conta.
  - **`updated_at`**: `string`, format: `date-time`

**Example:**

```json
{
  "data": [
    {
      "id": "Qm3xT7pLs9VdK2aYfR1c",
      "uid": "3kCKGqzlPFfCEj2X1Tkob07SN2M2",
      "label": "Loja",
      "postal_code": "01042001",
      "address": "Rua Barão de Itapetininga",
      "number": "255",
      "complement": "Sala 12",
      "district": "República",
      "city": "São Paulo",
      "state": "SP",
      "latitude": "",
      "longitude": "",
      "is_default": true,
      "created_at": "2025-03-14T18:22:05.000Z",
      "updated_at": "2025-03-14T18:22:05.000Z"
    }
  ]
}
```

### 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.
- `UserAddress` — shown above.