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

# Lista buyers

`GET /v2/buyers`

## Request

- Base URL: `https://api.barte.com`
- URL: `https://api.barte.com/v2/buyers`
- Auth: API key in header `X-Token-Api`
- TypeScript: <https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/docs/v2/buyers/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/barte/apis/api-de-sellers-v2-atualizada.md) - [All operations](https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/llms.txt) - [OpenAPI document](https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/revisions/f0dd55b167f1?raw)