Procurement Intelligence

Independent API for UK procurement intelligence: search opportunities, get details, buyer history, awarded contracts, and company matching from Contracts Finder and Find a Tender.

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

{
  "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 -i -X POST "https://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

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

{
  "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 -i -X POST "https://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

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

{
  "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 -i -X POST "https://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

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

{
  "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 -i -X POST "https://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

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

{
  "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 -i -X POST "https://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