API Reference

Base URL: https://api.orcheus.com

Authentication

All requests (except /api/health) require a Bearer token in the Authorization header.

# Live key (billable)
Authorization: Bearer orch_live_xxxxxxxxxxxx

# Test key (free, sandboxed)
Authorization: Bearer orch_test_xxxxxxxxxxxx

Generate API keys from your dashboard.

Endpoints

GET/v1/companies/search?q={query}

Search UK companies by name or registration number. Returns normalised results from Companies House.

GET/v1/companies/{companyNumber}

Get full company details by Companies House number, including filing history and officers.

GET/v1/addresses/search?postcode={postcode}

Search UK addresses by postcode. Returns a list of address options with UDPRN identifiers.

GET/v1/addresses/{addressId}

Retrieve a full structured address by provider ID (UDPRN).

GET/v1/usage

Get current billing period usage summary for the authenticated organisation.

GET/api/health

Health check. Returns API status and version. No authentication required.

Response format

// Success
{
  "success": true,
  "requestId": "req_abc123",
  "data": { ... }
}

// Error
{
  "success": false,
  "requestId": "req_abc123",
  "error": {
    "code": "COMPANY_NOT_FOUND",
    "message": "Company not found"
  }
}

Rate limits & billing

Company lookupMetered — charged per call on Base plan
Address lookupMetered — charged per call on Base plan
Test keysFree, sandboxed — no real data, no billing
Rate limit60 requests / minute per API key

Ready to integrate?

Create an account, generate an API key, and make your first call in minutes.

Get started freeView pricing