---
title: "Lista buyers"
method: GET
path: "/v2/buyers"
tags: ["API v2 para criação de buyers"]
---

# Lista buyers

`GET /v2/buyers`

Retorna uma lista de buyers com base nos parâmetros de consulta fornecidos.

## Query parameters

- `document` string
- `email` string
- `name` string
- `page` integer
- `size` integer

## Response `200`

Lista de buyers recuperada com sucesso

- object
  - `content` BuyerV2Response[]
    - `uuid` string
    - `document` string
    - `name` string
    - `countryCode` string
    - `phone` string
    - `email` string
    - `alternativeEmail` string
  - `totalElements` integer
  - `totalPages` integer
  - `page` integer
  - `size` integer

## Other responses

- `401` — Não autorizado
- `403` — Acesso proibido
- `500` — Erro interno do servidor

---

[API](https://skmtc.net/barte/apis/api-de-sellers-v2-atualizada.md) · [All operations](https://skmtc.net/barte/apis/api-de-sellers-v2-atualizada/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/barte/api-de-sellers-v2-atualizada/revisions/f0dd55b167f1/schema)