---
title: "List privacy-safe AI Buyer Contexts"
method: GET
path: "/api/v2/buyers"
tags: ["Buyer Agent"]
---

# List privacy-safe AI Buyer Contexts

`GET /api/v2/buyers`

## Request

- Base URL: `https://www.hireeli.io`
- URL: `https://www.hireeli.io/api/v2/buyers`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Ranks tenant-pinned contexts by a transparent intent score. Probable and visitor-confirmed intent remain distinct; PII is excluded.

## Query parameters

- `minimum_score` integer
- `source` string
- `intent` string
- `stage` string
- `variant` string
- `since` string, date-time
- `limit` integer
- `offset` integer

## Headers

- `x-eli-tenant` string, uuid

## Response `200`

Paginated non-PII Buyer Context projections.

## Other responses

- `401`: Credential missing, invalid, expired or revoked.
- `403`: Workspace, role, scope, plan or feature does not permit this operation.
- `503`: A required security, billing, cap, audit, evidence or storage check is unavailable. Writes fail closed.

---

[API](https://skmtc.dev/hireeli/apis/eli-api.md) · [All operations](https://skmtc.dev/hireeli/apis/eli-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hireeli/apis/eli-api/revisions/3272729fecd2?raw)