---
title: "Search for a buyer by id"
method: GET
path: "/v1/buyers/{buyer_id}"
tags: ["Buyers"]
---

# Search for a buyer by id

`GET /v1/buyers/{buyer_id}`

## Request

- Base URL: `https://api.edubank.com.br` (the document declares no server; this is the origin it was published from)
- URL: `https://api.edubank.com.br/v1/buyers/{buyer_id}`
- Auth: one of:
  - API key in header `x-api-key`
  - API key in header `authorization`
- TypeScript: <https://skmtc.dev/edubank/apis/api-edubank/docs/v1/buyers/:buyer_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Search for a buyer by id

## Path parameters

- `buyer_id` string, required

## Response `200`

The record has been successfully getted

- EdubankBuyers
  - `id` string: Buyer id
  - `first_name` string, required: Buyer's first name
  - `last_name` string, required: Buyer's last name
  - `email` string: Buyer's email
  - `taxpayer_id` string, required: Buyer's CPF/CNPJ
  - `birthdate` string: Buyer's date of birth
  - `phone_number` string: Buyer's phone number
  - `address` EdubankBuyersAddress, required
    - `city` string, required: City
    - `additional_information` string: Additional address data. In this field you can inform complement, references
    - `number` string, required: Number
    - `state_code` string, required: State (UF)
    - `street` string, required: Street / Patio
    - `neighborhood` string, required: Neighborhood
    - `zip` string, required: Postal Zone / ZIP Code)
    - `country_code` 'BR', required: Buyer's country code

## Other responses

- `400`: Client specified an invalid argument, request body or query param
- `401`: The user is unauthorized
- `403`: Authenticated user is not allowed to access this resource
- `404`: The resource was not found
- `408`: Request timeout
- `429`: Too many requests
- `500`: Internal server error

---

[API](https://skmtc.dev/edubank/apis/api-edubank.md) - [All operations](https://skmtc.dev/edubank/apis/api-edubank/llms.txt) - [OpenAPI document](https://skmtc.dev/edubank/apis/api-edubank/revisions/dce4008191d4?raw)