Procurement Intelligence API Documentation

POSThttps://www.brainiac.software/api/v1/procurement-intelligence/search$0.02 USDC

Search procurement opportunities

Search UK procurement opportunities from Contracts Finder and Find a Tender with filtering by date, stage, keyword, CPV, location, and value.

Body

Field	Required	Notes
`publishedFrom`	No	string; date
`publishedTo`	No	string; date
`stages`	No	array; Array
`keyword`	No	string
`cpvCode`	No	string
`location`	No	string
`minValue`	No	number
`maxValue`	No	number
`limit`	Yes	integer; Default: 20
`cursor`	No	string

Request exampleJSON

{
  "publishedFrom": "2026-01-01",
  "limit": 10
}

Response exampleJSON

{
  "retrievedAt": "2026-10-29T12:00:00.000Z",
  "query": {
    "publishedFrom": "2026-01-01",
    "publishedTo": null,
    "stages": null,
    "keyword": null,
    "cpvCode": null,
    "location": null,
    "minValue": null,
    "maxValue": null
  },
  "results": [
    {
      "ocid": "ocds-abc123-def456",
      "noticeId": "notice-123",
      "buyerId": "GB-ORG-123",
      "buyerName": "Department for Digital, Culture, Media and Sport",
      "title": "IT Services Contract",
      "description": "Provision of IT support services.",
      "stage": "tender",
      "status": "active",
      "publishedDate": "2026-01-15T00:00:00.000Z",
      "modifiedDate": "2026-01-20T00:00:00.000Z",
      "submissionDeadline": "2026-02-15T00:00:00.000Z",
      "value": 500000,
      "currency": "GBP",
      "cpvCodes": [
        "72000000"
      ],
      "locations": [
        "London"
      ],
      "category": "IT services",
      "procedure": "Open",
      "smeSuitable": true,
      "documents": [
        {
          "type": "notice",
          "url": "https://example.com/document.pdf"
        }
      ],
      "sourceUrl": null,
      "awardedSupplier": null,
      "awardValue": null,
      "awardDate": null,
      "contractDetails": null
    }
  ],
  "resultCount": 1,
  "sources": [
    {
      "source": "UK Contracts Finder",
      "status": "OK",
      "url": "https://www.contractsfinder.service.gov.uk/Published/Notices/OCDS/Search",
      "retrievedAt": "2026-10-29T12:00:00.000Z"
    },
    {
      "source": "UK Find a Tender",
      "status": "OK",
      "url": "https://www.find-tender.service.gov.uk/api/1.0/ocdsReleasePackages",
      "retrievedAt": "2026-10-29T12:00:00.000Z"
    }
  ],
  "limitations": [
    "UK Contracts Finder and Find a Tender APIs filter by date, stage, and identifiers only.",
    "Keyword, CPV, location, and value filtering is performed locally against returned records."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/procurement-intelligence/search" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "publishedFrom": "2026-01-01",
  "limit": 10
}
JSON

POSThttps://www.brainiac.software/api/v1/procurement-intelligence/opportunity$0.03 USDC

Get opportunity details

Retrieve full details of a procurement opportunity by OCID from UK Contracts Finder or Find a Tender.

Body

Field	Required	Notes
`ocid`	Yes	string

Request exampleJSON

{
  "ocid": "ocds-abc123-def456"
}

Response exampleJSON

{
  "retrievedAt": "2026-10-29T12:00:00.000Z",
  "ocid": "ocds-abc123-def456",
  "found": true,
  "opportunity": {
    "ocid": "ocds-abc123-def456",
    "noticeId": "notice-123",
    "buyerId": "GB-ORG-123",
    "buyerName": "Department for Digital, Culture, Media and Sport",
    "title": "IT Services Contract",
    "description": "Provision of IT support services.",
    "stage": "tender",
    "status": "active",
    "publishedDate": "2026-01-15T00:00:00.000Z",
    "modifiedDate": "2026-01-20T00:00:00.000Z",
    "submissionDeadline": "2026-02-15T00:00:00.000Z",
    "value": 500000,
    "currency": "GBP",
    "cpvCodes": [
      "72000000"
    ],
    "locations": [
      "London"
    ],
    "category": "IT services",
    "procedure": "Open",
    "smeSuitable": true,
    "documents": [
      {
        "type": "notice",
        "url": "https://example.com/document.pdf"
      }
    ],
    "sourceUrl": null,
    "awardedSupplier": null,
    "awardValue": null,
    "awardDate": null,
    "contractDetails": null
  },
  "source": "UK Contracts Finder",
  "sources": [
    {
      "source": "UK Contracts Finder",
      "status": "OK",
      "url": "https://www.contractsfinder.service.gov.uk/Published/OCDS/Record/ocds-abc123-def456",
      "retrievedAt": "2026-10-29T12:00:00.000Z"
    },
    {
      "source": "UK Find a Tender",
      "status": "OK",
      "url": "https://www.find-tender.service.gov.uk/api/1.0/ocdsReleasePackages/ocds-abc123-def456",
      "retrievedAt": "2026-10-29T12:00:00.000Z"
    }
  ],
  "limitations": [
    "Opportunity details are from the source that first returned data.",
    "Some fields may be missing depending on what the buyer has published."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/procurement-intelligence/opportunity" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "ocid": "ocds-abc123-def456"
}
JSON

POSThttps://www.brainiac.software/api/v1/procurement-intelligence/buyer$0.05 USDC

Get buyer procurement history

Retrieve procurement history for a buyer from UK Contracts Finder and Find a Tender.

Body

Field	Required	Notes
`buyerId`	Yes	string
`limit`	Yes	integer; Default: 20

Request exampleJSON

{
  "buyerId": "GB-ORG-123",
  "limit": 10
}

Response exampleJSON

{
  "retrievedAt": "2026-10-29T12:00:00.000Z",
  "buyerId": "GB-ORG-123",
  "opportunities": [
    {
      "ocid": "ocds-abc123-def456",
      "noticeId": "notice-123",
      "buyerId": "GB-ORG-123",
      "buyerName": "Department for Digital, Culture, Media and Sport",
      "title": "IT Services Contract",
      "description": "Provision of IT support services.",
      "stage": "tender",
      "status": "active",
      "publishedDate": "2026-01-15T00:00:00.000Z",
      "modifiedDate": "2026-01-20T00:00:00.000Z",
      "submissionDeadline": "2026-02-15T00:00:00.000Z",
      "value": 500000,
      "currency": "GBP",
      "cpvCodes": [
        "72000000"
      ],
      "locations": [
        "London"
      ],
      "category": "IT services",
      "procedure": "Open",
      "smeSuitable": true,
      "documents": [
        {
          "type": "notice",
          "url": "https://example.com/document.pdf"
        }
      ],
      "sourceUrl": null,
      "awardedSupplier": null,
      "awardValue": null,
      "awardDate": null,
      "contractDetails": null
    }
  ],
  "opportunityCount": 1,
  "sources": [
    {
      "source": "UK Contracts Finder",
      "status": "OK",
      "url": "https://www.contractsfinder.service.gov.uk/Published/Notices/OCDS/Search",
      "retrievedAt": "2026-10-29T12:00:00.000Z"
    },
    {
      "source": "UK Find a Tender",
      "status": "OK",
      "url": "https://www.find-tender.service.gov.uk/api/1.0/ocdsReleasePackages",
      "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."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/procurement-intelligence/buyer" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "buyerId": "GB-ORG-123",
  "limit": 10
}
JSON

POSThttps://www.brainiac.software/api/v1/procurement-intelligence/awards$0.05 USDC

Get awarded contracts

Retrieve awarded contracts and suppliers from UK Contracts Finder and Find a Tender by OCID or buyer ID.

Body

Field	Required	Notes
`ocid`	No	string
`buyerId`	No	string
`limit`	Yes	integer; Default: 20

Request exampleJSON

{
  "buyerId": "GB-ORG-123",
  "limit": 10
}

Response exampleJSON

{
  "retrievedAt": "2026-10-29T12:00:00.000Z",
  "ocid": null,
  "buyerId": "GB-ORG-123",
  "awards": [
    {
      "ocid": "ocds-xyz789-uvw012",
      "noticeId": "award-456",
      "buyerId": "GB-ORG-123",
      "buyerName": "Department for Digital, Culture, Media and Sport",
      "title": "IT Services Contract",
      "description": "Provision of IT support services.",
      "stage": "award",
      "status": "complete",
      "publishedDate": "2026-01-15T00:00:00.000Z",
      "modifiedDate": "2026-03-01T00:00:00.000Z",
      "submissionDeadline": null,
      "value": 500000,
      "currency": "GBP",
      "cpvCodes": [
        "72000000"
      ],
      "locations": [
        "London"
      ],
      "category": "IT services",
      "procedure": "Open",
      "smeSuitable": true,
      "documents": [
        {
          "type": "award",
          "url": "https://example.com/award.pdf"
        }
      ],
      "sourceUrl": null,
      "awardedSupplier": "Example IT Solutions Ltd",
      "awardValue": 480000,
      "awardDate": "2026-03-01T00:00:00.000Z",
      "contractDetails": {
        "startDate": "2026-04-01",
        "endDate": "2027-03-31"
      }
    }
  ],
  "awardCount": 1,
  "sources": [
    {
      "source": "UK Contracts Finder",
      "status": "OK",
      "url": "https://www.contractsfinder.service.gov.uk/Published/Notices/OCDS/Search",
      "retrievedAt": "2026-10-29T12:00:00.000Z"
    },
    {
      "source": "UK Find a Tender",
      "status": "OK",
      "url": "https://www.find-tender.service.gov.uk/api/1.0/ocdsReleasePackages",
      "retrievedAt": "2026-10-29T12:00:00.000Z"
    }
  ],
  "limitations": [
    "Awards are retrieved by filtering for award-stage notices.",
    "Not all awarded contracts may be available through these public APIs."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/procurement-intelligence/awards" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "buyerId": "GB-ORG-123",
  "limit": 10
}
JSON

POSThttps://www.brainiac.software/api/v1/procurement-intelligence/match$0.10 USDC

Match company to opportunities

Match a company profile against available procurement opportunities from UK Contracts Finder and Find a Tender with transparent scoring.

Body

Field	Required	Notes
`companyProfile`	Yes	object; Object
`publishedFrom`	No	string; date
`publishedTo`	No	string; date
`limit`	Yes	integer; Default: 20

Request exampleJSON

{
  "companyProfile": {
    "name": "Example Ltd",
    "industries": [
      "IT Services"
    ],
    "keywords": [
      "software"
    ]
  },
  "limit": 10
}

Response exampleJSON

{
  "retrievedAt": "2026-10-29T12:00:00.000Z",
  "companyProfile": {
    "name": "Example Ltd",
    "industries": [
      "IT Services"
    ],
    "keywords": [
      "software"
    ],
    "locations": [
      "London"
    ],
    "minValue": 100000,
    "maxValue": 1000000
  },
  "matches": [
    {
      "ocid": "ocds-abc123-def456",
      "noticeId": "notice-123",
      "buyerId": "GB-ORG-123",
      "buyerName": "Department for Digital, Culture, Media and Sport",
      "title": "IT Services Contract",
      "description": "Provision of IT support services.",
      "stage": "tender",
      "status": "active",
      "publishedDate": "2026-01-15T00:00:00.000Z",
      "modifiedDate": "2026-01-20T00:00:00.000Z",
      "submissionDeadline": "2026-02-15T00:00:00.000Z",
      "value": 500000,
      "currency": "GBP",
      "cpvCodes": [
        "72000000"
      ],
      "locations": [
        "London"
      ],
      "category": "IT services",
      "procedure": "Open",
      "smeSuitable": true,
      "documents": [
        {
          "type": "notice",
          "url": "https://example.com/document.pdf"
        }
      ],
      "sourceUrl": null,
      "awardedSupplier": null,
      "awardValue": null,
      "awardDate": null,
      "contractDetails": null,
      "matchExplanation": [
        "Industry match found in opportunity title, description, or category.",
        "Keywords match found in opportunity title or description.",
        "Location match found.",
        "Value meets minimum threshold.",
        "Value within maximum threshold."
      ],
      "matchScore": 75
    }
  ],
  "matchCount": 1,
  "sources": [
    {
      "source": "UK Contracts Finder",
      "status": "OK",
      "url": "https://www.contractsfinder.service.gov.uk/Published/Notices/OCDS/Search",
      "retrievedAt": "2026-10-29T12:00:00.000Z"
    },
    {
      "source": "UK Find a Tender",
      "status": "OK",
      "url": "https://www.find-tender.service.gov.uk/api/1.0/ocdsReleasePackages",
      "retrievedAt": "2026-10-29T12:00:00.000Z"
    }
  ],
  "limitations": [
    "Matching is based on published opportunity data and may not reflect all eligibility requirements.",
    "Match scores are heuristic indicators and do not guarantee a chance of winning."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/procurement-intelligence/match" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "companyProfile": {
    "name": "Example Ltd",
    "industries": [
      "IT Services"
    ],
    "keywords": [
      "software"
    ]
  },
  "limit": 10
}
JSON

POSThttps://www.brainiac.software/api/v1/procurement-intelligence/eu/notices/search$0.05 USDC

Search EU notices

Search published EU procurement notices from TED with filtering by keyword, CPV code, NUTS code, and date range.

Body

Field	Required	Notes
`keyword`	No	string
`cpvCode`	No	string
`nutsCode`	No	string
`startDate`	No	string
`endDate`	No	string
`limit`	Yes	integer; Default: 20

Request exampleJSON

{
  "keyword": "software",
  "limit": 20
}

Response exampleJSON

{
  "retrievedAt": "2026-10-29T12:00:00.000Z",
  "input": {
    "keyword": "software",
    "limit": 20
  },
  "notices": [],
  "total": 0,
  "sources": [
    {
      "source": "TED API",
      "url": "https://api.ted.europa.eu/v3/notices/search",
      "retrievedAt": "2026-10-29T12:00:00.000Z"
    }
  ],
  "limitations": [
    "TED API provides EU procurement notices.",
    "CPV and NUTS codes are hierarchical; consult official documentation."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/procurement-intelligence/eu/notices/search" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "keyword": "software",
  "limit": 20
}
JSON

POSThttps://www.brainiac.software/api/v1/procurement-intelligence/eu/notices/resolve$0.05 USDC

Resolve EU notice

Retrieve full details of an EU procurement notice from TED by notice ID.

Body

Field	Required	Notes
`noticeId`	Yes	string

Request exampleJSON

{
  "noticeId": "123456-2024"
}

Response exampleJSON

{
  "retrievedAt": "2026-10-29T12:00:00.000Z",
  "input": {
    "noticeId": "123456-2024"
  },
  "notice": null,
  "sources": [
    {
      "source": "TED API",
      "url": "https://api.ted.europa.eu/v3/notices/123456-2024",
      "retrievedAt": "2026-10-29T12:00:00.000Z"
    }
  ],
  "limitations": [
    "TED API provides full notice details in XML/JSON format.",
    "Award details may not be available for all notice types."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/procurement-intelligence/eu/notices/resolve" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "noticeId": "123456-2024"
}
JSON

POSThttps://www.brainiac.software/api/v1/procurement-intelligence/us/awards/search$0.05 USDC

Search US awards

Search federal contract awards from USAspending with filtering by keyword, recipient, agency, and fiscal year.

Body

Field	Required	Notes
`keyword`	No	string
`recipientId`	No	string
`agencyId`	No	string
`fiscalYear`	No	integer
`limit`	Yes	integer; Default: 20

Request exampleJSON

{
  "keyword": "software",
  "fiscalYear": 2024,
  "limit": 20
}

Response exampleJSON

{
  "retrievedAt": "2026-10-29T12:00:00.000Z",
  "input": {
    "keyword": "software",
    "fiscalYear": 2024,
    "limit": 20
  },
  "awards": [],
  "total": 0,
  "sources": [
    {
      "source": "USAspending API",
      "url": "https://api.usaspending.gov/api/v2/search/spending_by_award/",
      "retrievedAt": "2026-10-29T12:00:00.000Z"
    }
  ],
  "limitations": [
    "USAspending API provides federal contract awards.",
    "Data is limited to federal spending; state and local spending not included."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/procurement-intelligence/us/awards/search" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "keyword": "software",
  "fiscalYear": 2024,
  "limit": 20
}
JSON

POSThttps://www.brainiac.software/api/v1/procurement-intelligence/us/recipients/profile$0.05 USDC

Get US recipient profile

Retrieve recipient details from USAspending by recipient ID.

Body

Field	Required	Notes
`recipientId`	Yes	string

Request exampleJSON

{
  "recipientId": "123456"
}

Response exampleJSON

{
  "retrievedAt": "2026-10-29T12:00:00.000Z",
  "input": {
    "recipientId": "123456"
  },
  "profile": null,
  "sources": [
    {
      "source": "USAspending API",
      "url": "https://api.usaspending.gov/api/v2/recipient/123456",
      "retrievedAt": "2026-10-29T12:00:00.000Z"
    }
  ],
  "limitations": [
    "USAspending API provides recipient details for federal awards.",
    "Business names may vary across awards."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/procurement-intelligence/us/recipients/profile" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "recipientId": "123456"
}
JSON

POSThttps://www.brainiac.software/api/v1/procurement-intelligence/us/recipients/awards$0.05 USDC

Get US recipient awards

Retrieve award history for a US recipient from USAspending by recipient ID.

Body

Field	Required	Notes
`recipientId`	Yes	string
`limit`	Yes	integer; Default: 20

Request exampleJSON

{
  "recipientId": "123456",
  "limit": 20
}

Response exampleJSON

{
  "retrievedAt": "2026-10-29T12:00:00.000Z",
  "input": {
    "recipientId": "123456",
    "limit": 20
  },
  "awards": [],
  "total": 0,
  "sources": [
    {
      "source": "USAspending API",
      "url": "https://api.usaspending.gov/api/v2/recipient/123456/awards",
      "retrievedAt": "2026-10-29T12:00:00.000Z"
    }
  ],
  "limitations": [
    "USAspending API provides award history for recipients.",
    "Data is limited to federal awards."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/procurement-intelligence/us/recipients/awards" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "recipientId": "123456",
  "limit": 20
}
JSON

POSThttps://www.brainiac.software/api/v1/procurement-intelligence/us/agency-spend$0.05 USDC

Get US agency spend

Retrieve award spending data for a US federal agency from USAspending by agency ID.

Body

Field	Required	Notes
`agencyId`	Yes	string
`fiscalYear`	No	integer

Request exampleJSON

{
  "agencyId": "0970",
  "fiscalYear": 2024
}

Response exampleJSON

{
  "retrievedAt": "2026-10-29T12:00:00.000Z",
  "input": {
    "agencyId": "0970",
    "fiscalYear": 2024
  },
  "agencySpend": null,
  "sources": [
    {
      "source": "USAspending API",
      "url": "https://api.usaspending.gov/api/v2/agency/0970/awards/",
      "retrievedAt": "2026-10-29T12:00:00.000Z"
    }
  ],
  "limitations": [
    "USAspending API provides agency award spending data.",
    "Data is limited to federal agencies."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/procurement-intelligence/us/agency-spend" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "agencyId": "0970",
  "fiscalYear": 2024
}
JSON