Get Buyer By ID

GET /buyers/{buyerId}

Api key auth

Get a single buyer by ID

Path parameters

buyerId string(guid) Required

Unique ID of the buyer

Responses

200 application/json

A single buyer
Hide response attributes Show response attributes object
- id string(guid)
  
  System generated unique identifier. Don't include this in POST request body.
- company_name string
- company_ein string
- email string(email)
- phone string(phone)
- address1 string
- address2 string
- city string
- state string
- zip string
- country string
- website string
- price_list_id string(guid)
  
  Price List ID
- account_manager_id string(guid)
  
  Account Manager ID
- created_at string(date-time)
- updated_at string(date-time)

GET /buyers/{buyerId}

curl \
 --request GET 'https://app.getfoundation.com/api/external/v1/buyers/{buyerId}' \
 --header "X-API-Key: $API_KEY"

Response examples (200)

{
  "id": "9aa62446-c3b0-42f5-8027-3648daed9d73",
  "company_name": "Acme Corp",
  "company_ein": "11-23456789",
  "email": "hello@example.com",
  "phone": "+1 123 456 7890",
  "address1": "string",
  "address2": "string",
  "city": "string",
  "state": "string",
  "zip": "string",
  "country": "string",
  "website": "string",
  "price_list_id": "string",
  "account_manager_id": "string",
  "created_at": "2025-05-04T09:42:00Z",
  "updated_at": "2025-05-04T09:42:00Z"
}