1eye Docs – Buyer Signals API, Webhooks, MCP & Integrations

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

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:

buy_123456789012345678

Request

curl "https://api.1eye.ai/v1/buyers/buy_123456789012345678" \
  -H "Authorization: Bearer 1eye_live_xxxxxxxxx"

Response

A successful request returns the Buyer object directly.

{
  "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:

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:

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

Get Started

Buyers

Signals

Target Lists

Destinations

Knowledge Base

Workspace

Retrieve a Buyer

Path parameter

Request

Response

Resource access

Errors

​Path parameter

​Request

​Response

​Resource access

​Errors

Path parameter

Request

Response

Resource access

Errors