API reference · v1

List authorities

Authority directory in ascending ID order. A directory entry does not establish application coverage.

GET/v1/authorities

Send a secret API key in Authorization: Bearer YOUR_API_KEY. Each successful request uses one of your 500 monthly requests.

Parameters

limitquery · optional

Page size. 1–100, default 50.

Default: 50

Range: 1–100

cursorquery · optional

Opaque cursor from this endpoint with the same filters. Keep it unchanged; page size may change.

Response fields

itemsarray

Array of the items described below.

Show item fields

idstring

Identifier accepted by authority filters.

namestring

Official authority name.

nation"England" | "Scotland" | "Wales" | "Northern Ireland"

Value from the collected source record.

kind"local" | "county" | "national_park" | "special" | "regional"

Value from the collected source record.

officialCodestring · optional

Government authority code Omitted when not collected.

websitestring · optional

Authority website; omitted if not recorded.

sourceUrlstring

Absolute source URL. Council links may change or require a browser session.

verifiedAtstring

UTC timestamp when directory evidence was verified; not an application collection time.

startDatestring · optional

Authority start date (YYYY-MM-DD) Omitted when not collected.

endDatestring · optional

Authority end date (YYYY-MM-DD) Omitted when not collected.

successorIdsarray

Recorded successor authorities; empty when none recorded.

nextCursorstring | null

Continue with this cursor; null when this page exhausts the current query.

Errors

Error codes, request IDs, retry behaviour, and allowance headers apply to every endpoint. Invalid or repeated query parameters return 400; unavailable records return 404. Source failures never become successful empty results.