Four products. One control plane. One spec.

The OneGoodArea API exposes four composable products on one signal-first engine, plus a per-organisation control plane. Read the methodology to understand how the engine works. Open the interactive reference to query it.

Read the methodology Open the reference

Signals

4 endpoints

Raw normalised signal catalog per area. The primitive: every other product composes from this.

GET/v1/area
GET/v1/signals/:category
GET/v1/areas
GET/v1/meta

Scores

1 endpoint

Deterministic composite score per area. Four presets, custom weights, or saved organisation preset_id.

POST/v1/score

Monitor

7 endpoints

Portfolios of tracked areas. Bulk enrich, detect monthly change, fire signal.changed webhooks.

POST/v1/portfolios
GET/v1/portfolios
GET/v1/portfolios/:id
DELETE/v1/portfolios/:id
POST/v1/portfolios/:id/areas
POST/v1/portfolios/:id/enrich
POST/v1/portfolios/:id/changes

Intelligence

4 endpoints

Typed query plane. AI emits the plan; the database answers. 6 plan ops, 92.9% planner accuracy.

POST/v1/query
POST/v1/peers
POST/v1/insights
POST/v1/forecast

~32 endpointsAdmin / owner only

/v1/orgs (+ CRUD)
/v1/orgs/:id/bundles (+ CRUD)
/v1/orgs/:id/presets (+ CRUD)
/v1/orgs/:id/methodology (pin/unpin)
/v1/orgs/:id/cohorts (+ CRUD)
/v1/orgs/:id/members (+ CRUD, RBAC)
/v1/orgs/:id/invitations
/v1/webhooks

Full request shapes on the interactive reference . Methodology rationale on the Levers section of /methodology .

03.1

Methodology

14 sections covering signals, store, time-series, scoring, Intelligence, Levers, versioning. The why behind every endpoint.

Read methodology 03.2

Interactive reference

OpenAPI 3.0 spec auto-generated from the live Fastify schemas. Request shapes, response shapes, try-it-in-browser. Stays in step with the backend on every deploy.

Open reference

The engine ships today.

Get an API key and start scoring areas. The methodology and the reference are both live.

Get an API key Read the methodology