---
title: "Recupera um buyer por UUID"
method: GET
path: "/v2/buyers/{uuid}"
tags: ["API v2 para recuperação de buyers"]
---

# Recupera um buyer por UUID

`GET /v2/buyers/{uuid}`

## Request

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

Retorna os detalhes de um buyer específico com base no UUID fornecido.

## Path parameters

- `uuid` string, required

## Response `200`

buyer recuperado com sucesso

- BuyerDetailV2Response
  - `uuid` string
  - `document` string
  - `name` string
  - `countryCode` string
  - `phone` string
  - `email` string
  - `alternativeEmail` string
  - `address` AddressResponse
    - `street` string
    - `number` string
    - `complement` string
    - `district` string
    - `city` string
    - `state` string
    - `country` string
    - `zipCode` string
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `401`: Não autorizado
- `403`: Acesso proibido
- `404`: buyer não encontrado
- `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)