OroIntelDocs
OpenAPISign up now
For agents:start at/llms.txt·everything as Markdown at/llms-full.txt·or add theMCP server.

API

Base URL https://api.oro-intel.com. Every request needs an Authorization: Bearer oro_… header. The full machine-readable schema is the OpenAPI 3.1 spec. New here? Start with the quickstart.

Credit costs

ActionAPIMCP toolCredits
Search noticesGET /v1/notices/searchoro_search_notices2
Search live tendersGET /v1/tenders/searchoro_search_tenders2
Look up a contractGET /v1/contracts/{notice_id}oro_lookup_contract5
Contract documentsGET /v1/contracts/{notice_id}/documentsoro_contract_documents10
Look up a companyGET /v1/companies/searchoro_lookup_company5
Company contracts wonGET /v1/companies/{company_number}/contractsoro_company_contracts10
Full company profile (flagship)GET /v1/companies/{company_number}/profileoro_company_profile12
Look up a buyerGET /v1/buyers/{buyer_id}oro_lookup_buyer5
Buyer contracts issuedGET /v1/buyers/{buyer_id}/contractsoro_buyer_contracts10
Buyer profileGET /v1/buyers/{buyer_id}/profileoro_buyer_profile20
Look up a frameworkGET /v1/frameworks/{framework_id}oro_lookup_framework5
Bulk exportPOST /v1/exportsoro_bulk_export100 / 1,000 rows
Get balanceGET /v1/balanceoro_get_balancefree

The flagship: company profile

GET /v1/companies/{company_number}/profile returns everything under a company in one call, the core record plus every public contract it has won, for 12 credits, cheaper than buying those layers separately. It's the right default when you need a full picture. The Companies House registration number, where we hold it, is part of the core record.

Response shape

Every metered response echoes what it cost and what you have left:

json
{ "core": { "...": "..." },
  "contracts": { "contract_count": 132, "items": [ "..." ] },
  "credits_charged": 12,
  "credits_remaining": 233 }

Endpoints

Copy-paste examples for every endpoint. All read the key from the ORO_API_KEY environment variable (create one, 250 free credits). Replace UPPER_CASE placeholders with real ids from a search or lookup call.

Search notices — 2 credits

GET /v1/notices/search · MCP tool oro_search_notices

curl -s "https://api.oro-intel.com/v1/notices/search?query=EV%20charging&limit=5" \
  -H "Authorization: Bearer $ORO_API_KEY"
response (trimmed)
{
  "items": [ { "notice_id": "…", "title": "EV Charging Infrastructure…", "buyer": "…", "published": "2026-06-30" } ],
  "count": 5,
  "credits_charged": 2,
  "credits_remaining": 233
}

Search live tenders — 2 credits

GET /v1/tenders/search · MCP tool oro_search_tenders

curl -s "https://api.oro-intel.com/v1/tenders/search?query=cyber%20security&limit=5" \
  -H "Authorization: Bearer $ORO_API_KEY"
response (trimmed)
{
  "items": [ { "notice_id": "…", "title": "Cyber Security Services…", "deadline": "2026-08-14" } ],
  "count": 5,
  "credits_charged": 2,
  "credits_remaining": 233
}

Look up a contract — 5 credits

GET /v1/contracts/{notice_id} · MCP tool oro_lookup_contract

curl -s "https://api.oro-intel.com/v1/contracts/NOTICE_ID" \
  -H "Authorization: Bearer $ORO_API_KEY"
response (trimmed)
{
  "notice_id": "…", "title": "…", "buyer": "…", "supplier": "…", "value": 1250000,
  "credits_charged": 5,
  "credits_remaining": 233
}

Contract documents — 10 credits

GET /v1/contracts/{notice_id}/documents · MCP tool oro_contract_documents

curl -s "https://api.oro-intel.com/v1/contracts/NOTICE_ID/documents" \
  -H "Authorization: Bearer $ORO_API_KEY"
response (trimmed)
{
  "documents": [ { "name": "Specification.pdf", "url": "…" } ],
  "credits_charged": 10,
  "credits_remaining": 233
}

Look up a company — 5 credits

GET /v1/companies/search · MCP tool oro_lookup_company

curl -s "https://api.oro-intel.com/v1/companies/search?name=Serco" \
  -H "Authorization: Bearer $ORO_API_KEY"
response (trimmed)
{
  "id": "…", "name": "SERCO LIMITED", "companies_house_number": "02048608",
  "is_sme": false, "locality": "…",
  "credits_charged": 5,
  "credits_remaining": 233
}

Company contracts won — 10 credits

GET /v1/companies/{company_number}/contracts · MCP tool oro_company_contracts

curl -s "https://api.oro-intel.com/v1/companies/02048608/contracts" \
  -H "Authorization: Bearer $ORO_API_KEY"
response (trimmed)
{
  "contract_count": 132,
  "items": [ { "notice_id": "…", "title": "…", "value": 940000 } ],
  "credits_charged": 10,
  "credits_remaining": 233
}

Full company profile (flagship) — 12 credits

GET /v1/companies/{company_number}/profile · MCP tool oro_company_profile

curl -s "https://api.oro-intel.com/v1/companies/02048608/profile" \
  -H "Authorization: Bearer $ORO_API_KEY"
response (trimmed)
{
  "core": { "name": "SERCO LIMITED", "company_number": "02048608", "…": "…" },
  "contracts": { "contract_count": 132, "items": [ "…" ] },
  "credits_charged": 12,
  "credits_remaining": 233
}

Look up a buyer — 5 credits

GET /v1/buyers/{buyer_id} · MCP tool oro_lookup_buyer

curl -s "https://api.oro-intel.com/v1/buyers/BUYER_ID" \
  -H "Authorization: Bearer $ORO_API_KEY"
response (trimmed)
{
  "buyer_id": "…", "name": "Ministry of Defence", "region": "…",
  "credits_charged": 5,
  "credits_remaining": 233
}

Buyer contracts issued — 10 credits

GET /v1/buyers/{buyer_id}/contracts · MCP tool oro_buyer_contracts

curl -s "https://api.oro-intel.com/v1/buyers/BUYER_ID/contracts" \
  -H "Authorization: Bearer $ORO_API_KEY"
response (trimmed)
{
  "contract_count": 480,
  "items": [ { "notice_id": "…", "title": "…", "supplier": "…" } ],
  "credits_charged": 10,
  "credits_remaining": 233
}

Buyer profile — 20 credits

GET /v1/buyers/{buyer_id}/profile · MCP tool oro_buyer_profile

curl -s "https://api.oro-intel.com/v1/buyers/BUYER_ID/profile" \
  -H "Authorization: Bearer $ORO_API_KEY"
response (trimmed)
{
  "core": { "name": "Ministry of Defence", "…": "…" },
  "contracts": { "contract_count": 480, "items": [ "…" ] },
  "credits_charged": 20,
  "credits_remaining": 233
}

Look up a framework — 5 credits

GET /v1/frameworks/{framework_id} · MCP tool oro_lookup_framework

curl -s "https://api.oro-intel.com/v1/frameworks/FRAMEWORK_ID" \
  -H "Authorization: Bearer $ORO_API_KEY"
response (trimmed)
{
  "framework_id": "…", "title": "…", "lots": [ "…" ],
  "credits_charged": 5,
  "credits_remaining": 233
}

Bulk export — 100 / 1,000 rows credits

POST /v1/exports · MCP tool oro_bulk_export

curl -s -X POST "https://api.oro-intel.com/v1/exports" \
  -H "Authorization: Bearer $ORO_API_KEY"
response (trimmed)
{
  "export_id": "…", "status": "processing", "rows": 1000,
  "credits_charged": 100,
  "credits_remaining": 233
}

Get balance — free

GET /v1/balance · MCP tool oro_get_balance

curl -s "https://api.oro-intel.com/v1/balance" \
  -H "Authorization: Bearer $ORO_API_KEY"
response (trimmed)
{
  "balance": 250,
  "credits_charged": 0,
  "credits_remaining": 250
}

Next