Examples

A common flow: you have a company name, and you want its full procurement picture.

Company by name → full profile

# 1. Find the company (5 credits)
curl -s "https://api.oro-intel.com/v1/companies/search?name=Capita" \
  -H "Authorization: Bearer $ORO_KEY"
# -> { "id": "...", "name": "CAPITA PLC", "companies_house_number": "02081330",
#      "credits_charged": 5, "credits_remaining": 245 }

# 2. Pull the full profile (12 credits)
curl -s "https://api.oro-intel.com/v1/companies/02081330/profile" \
  -H "Authorization: Bearer $ORO_KEY"
# -> { "core": {...}, "contracts": { "contract_count": 132, "items": [...] },
#      "credits_charged": 12, "credits_remaining": 233 }

From MCP

Call oro_company_profile with { "company_number": "02081330" } (or { "name": "Capita" }) for the same result. The tool resolves the company and returns the core record plus every won contract in one call, charging 12 credits on success.

Tips

• Send a stable Idempotency-Key header per logical request so retries never double-bill.
• Check credits_remaining on each response and top up before you hit zero.
• Prefer the profile bundle over separate lookups when you need the whole picture, it's cheaper.