API Documentation

Last updated: June 2026

AtlasRevenue provides a JSON API for integrating procurement intelligence into your CRM, bid management tools, or internal dashboards. The API is available on Agency plans and above.

Authentication

All API requests require an Authorization: Bearer <your-api-key> header. API keys are provisioned for Agency accounts — contact hello@atlasrevenue.co.uk to request access.

Base URL

https://atlasrevenue.io

Endpoints

Create a scan

POST /api/scans

Submit a company profile for scanning. Returns the scan ID for polling status.

Request body (JSON):

companyName (required) — company name
mainServices (required) — primary services offered
location — UK region or office location
idealBuyers — target buyer types
teamSize — staff count band
idealContractSize — preferred contract value range
All other scan fields are optional enrichment

Get scan status

GET /api/scans/:id/status

Returns the current stage, progress percentage, and completion status.

Get scan result

GET /api/scans/:id

Returns the full scan data including procurement notices, evidence grade, verdict, and structured report sections.

Get scan data (JSON)

GET /api/scans/:id/data.json

Returns the raw procurement data: contract notices, buyer list, spend figures, and keyword matches.

Get report (Markdown)

GET /api/scans/:id/report.md

Returns the AI-generated 10-section report in Markdown format.

Download PDF

GET /api/scans/:id/report.pdf

Returns the rendered A4 PDF report.

Rate limits

API access is rate-limited to 60 requests per minute per API key. Scan creation is limited to 10 per hour.

Buyer Graph API Public

List / search buyers

GET /api/buyers?q=nhs+trust&limit=20

Returns top buyers by awarded spend (default) or filtered by name query. No authentication required.

Buyer profile

GET /api/buyers/:id

Returns a full buyer profile: entity details, Companies House data, officers, procurement history (up to 100 records), top categories, and top incumbent suppliers. No authentication required.

Signal API Public

Latest signals

GET /api/signals/latest

Returns the most recent procurement signal per sector desk, plus hero and ticker signals for the homepage feed.

Early signals

GET /api/early-signals?limit=50

Returns macro early signals from ONS construction data, DLUHC Planning Data, GOV.UK policy publications, and Land Registry. No authentication required. limit max 200.

Early signals by desk

GET /api/early-signals/desk/:slug

Returns early signals filtered to a specific intelligence desk category. No authentication required.

Lifecycle API Public

Lifecycle summary

GET /api/lifecycle/summary

Returns aggregate lifecycle stage distribution across all tracked contracts.

Recent transitions

GET /api/lifecycle/transitions?limit=50

Returns recently detected lifecycle stage transitions — contracts that moved from open to awarded, or from pipeline to active procurement.

Lifecycle by desk

GET /api/lifecycle/desk/:category

Returns lifecycle entries for a specific desk category.

Supplier Graph API Public

List suppliers

GET /api/suppliers?q=siemens&limit=50&offset=0

Returns supplier entities ordered by total contract wins. Supports text search by name. No authentication required.

Supplier profile

GET /api/suppliers/:id

Returns a full supplier profile: entity details, Companies House data, all contract wins with buyer names and values, top buyers, and top categories. No authentication required.

Webhooks (coming soon)

We are building webhook support to push scan-complete and weekly-alert events to your endpoint. Register interest by emailing hello@atlasrevenue.co.uk.

Need help?

For API support, integration guidance, or to request access: hello@atlasrevenue.co.uk