# BRAINIAC Procurement Intelligence – Buyer History

> BRAINIAC Procurement Intelligence – Buyer History is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.05/call, status unknown (last checked 2026-11-15).

Retrieves a buyer's procurement history and active tender opportunities from UK government contract sources by buyer ID

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/procurement-intelligence/buyer?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-procurement-intelligence-buyer-history-27cfbef7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hVm76MOVLu_p4mnAQyJdu

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability brainiac-procurement-intelligence-buyer-history-27cfbef7 -d '<json body>'
```

Example prompt: Can you pull up the procurement history for UK buyer GB-ORG-123 — I want to see their latest 50 tender opportunities including active ones and any recent awards?

## When to prefer this

Use this endpoint when you need to research a specific known UK government buyer by their organisation ID — it aggregates data from both UK Contracts Finder and Find a Tender in one call. Prefer it over generic search endpoints when you already have the buyer's ID and want their full tender history or active opportunities. Not suitable for supplier-side lookups, non-UK procurement, or keyword-based opportunity searches without a known buyer ID.

## Known failure modes

- Invalid or non-existent buyerId returns empty opportunities array or error
- limit outside 1–100 range returns validation error
- Upstream UK Contracts Finder or Find a Tender API unavailability causes source status errors or incomplete results
- Historical records may be incomplete due to upstream API pagination limits
- No results found for buyers with no publicly listed tender history

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

Returns a JSON object containing the buyer ID, a list of procurement opportunities (each with title, stage, status, value, currency, CPV codes, procedure type, submission deadline, awarded supplier if applicable, document URLs, and locations), the total opportunity count, data source details including retrieval timestamps, and any limitations on data coverage.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 20,
   "maximum": 100,
   "minimum": 1
  },
  "buyerId": {
   "type": "string",
   "maxLength": 100,
   "minLength": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "buyerId": "GB-ORG-123",
  "sources": [
   {
    "url": "https://www.contractsfinder.service.gov.uk/Published/Notices/OCDS/Search",
    "source": "UK Contracts Finder",
    "status": "OK",
    "retrievedAt": "2026-10-29T12:00:00.000Z"
   },
   {
    "url": "https://www.find-tender.service.gov.uk/api/1.0/ocdsReleasePackages",
    "source": "UK Find a Tender",
    "status": "OK",
    "retrievedAt": "2026-10-29T12:00:00.000Z"
   }
  ],
  "limitations": [
   "Buyer history is retrieved by filtering all recent records for the buyer ID.",
   "History may not include all historical opportunities due to API limitations."
  ],
  "retrievedAt": "2026-10-29T12:00:00.000Z",
  "opportunities": [
   {
    "ocid": "ocds-abc123-def456",
    "stage": "tender",
    "title": "IT Services Contract",
    "value": 500000,
    "status": "active",
    "buyerId": "GB-ORG-123",
    "category": "IT services",
    "cpvCodes": [
     "72000000"
    ],
    "currency": "GBP",
    "noticeId": "notice-123",
    "awardDate": null,
    "buyerName": "Department for Digital, Culture, Media and Sport",
    "documents": [
     {
      "url": "https://example.com/document.pdf",
      "type": "notice"
     }
    ],
    "locations": [
     "London"
    ],
    "procedure": "Open",
    "sourceUrl": null,
    "awardValue": null,
    "description": "Provision of IT support services.",
    "smeSuitable": true,
    "modifiedDate": "2026-01-20T00:00:00.000Z",
    "publishedDate": "2026-01-15T00:00:00.000Z",
    "awardedSupplier": null,
    "contractDetails": null,
    "submissionDeadline": "2026-02-15T00:00:00.000Z"
   }
  ],
  "opportunityCount": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-procurement-intelligence-buyer-history-27cfbef7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
