> ## Documentation Index
> Fetch the complete documentation index at: https://docs.1eye.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve a Buyer

> Retrieve a specific Buyer using its 1eye Buyer ID.

Returns a single Buyer belonging to the workspace associated with your API key.

```text theme={null}
GET /v1/buyers/{buyer_id}
```

## Path parameter

| Parameter  | Type   | Description                                                 |
| :--------- | :----- | :---------------------------------------------------------- |
| `buyer_id` | string | The 1eye Buyer ID to retrieve. Buyer IDs begin with `buy_`. |

Example Buyer ID:

```text theme={null}
buy_123456789012345678
```

## Request

```text theme={null}
curl "https://api.1eye.ai/v1/buyers/buy_123456789012345678" \
  -H "Authorization: Bearer 1eye_live_xxxxxxxxx"
```

## Response

A successful request returns the Buyer object directly.

```text theme={null}
{
  "id": "buy_123456789012345678",
  "client_id": "wor_123456789012345678",
  "contact_info": {
    "name": {
      "first": "Jane",
      "middle": "",
      "last": "Doe"
    },
    "role": {
      "title": "VP of Sales",
      "function": "sales",
      "seniority": "vp",
      "start_date": ""
    },
    "email": {
      "work": "jane@example.com",
      "is_valid": true
    },
    "phone": {
      "mobile": "+14155550123",
      "is_valid": true
    },
    "social": {
      "linkedin": "https://www.linkedin.com/in/janedoe",
      "twitter": "",
      "github": "",
      "facebook": "",
      "linkedin_followers": 0,
      "is_linkedin_valid": true
    },
    "location": {
      "city": "San Francisco",
      "state": "California",
      "country": "United States",
      "postal_code": ""
    },
    "photo_url": "https://example.com/photo.jpg",
    "is_persona": true,
    "persona_id": "per_123456789012345678",
    "persona_name": "Sales",
    "persona_reasoning": "The contact's role and seniority align with the Sales persona."
  },
  "company_info": {
    "name": "Acme",
    "website": "acme.com",
    "logo": "https://example.com/logo.png",
    "industries": [
      "computer software"
    ],
    "employee_count": 250,
    "founded_year": 2018,
    "annual_revenue": 50000000,
    "company_type": "private",
    "social": {
      "linkedin": "https://www.linkedin.com/company/acme",
      "twitter": "",
      "facebook": ""
    },
    "location": {
      "street_address": "123 Market St",
      "city": "San Francisco",
      "state": "California",
      "postal_code": "94105",
      "country": "United States"
    },
    "total_funding": 25000000,
    "latest_funding_stage": "",
    "latest_funding_round_date": "",
    "is_icp": true,
    "icp_id": "icp_123456789012345678",
    "icp_name": "B2B-SCALEUP",
    "icp_reasoning": "The company matches the workspace's B2B Scaleup ICP."
  },
  "hems": [],
  "target_lists": [
    {
      "id": "lis_123456789012345678",
      "name": "Website Visitors"
    }
  ],
  "signal_count": {
    "total": 3,
    "website": 2,
    "market": 1,
    "linkedin": 0
  },
  "attribution": {
    "type": "paid",
    "source": "google_ads",
    "source_name": "Google Ads",
    "source_logo": "https://example.com/google-ads.png"
  },
  "first_signal_id": "sig_123456789012345678",
  "first_signal_type": "website",
  "first_signal_trigger": "visited_page",
  "last_signal_id": "sig_987654321098765432",
  "last_signal_type": "market",
  "last_signal_trigger": "evaluated_competitor",
  "created_at": "2026-09-20T18:27:36Z",
  "updated_at": "2026-09-25T19:03:28Z"
}
```

The Buyer object includes contact and company information, ICP and Persona evaluation, Target Lists, Signal counts, attribution, and first and last Signal details.

`signal_count` uses the same Signal type naming as the Signals API:

```text theme={null}
website
market
linkedin
```

## Resource access

An API key can only retrieve Buyers belonging to its associated workspace.

If the Buyer does not exist or belongs to another workspace, the API returns:

```text theme={null}
404 Not Found
```

The API does not reveal whether a Buyer exists in another workspace.

## Errors

| Status | Error Code             | Description                                                 |
| :----- | :--------------------- | :---------------------------------------------------------- |
| `401`  | `authentication_error` | The API key is missing, invalid, or revoked                 |
| `404`  | `not_found`            | The Buyer does not exist or is unavailable to the workspace |
| `429`  | `rate_limit_exceeded`  | The workspace has exceeded an API rate limit                |
| `500`  | `internal_error`       | An unexpected server error occurred                         |
| `503`  | `service_unavailable`  | The API is temporarily unavailable                          |