API reference · v1

Retrieve an authority

Authority details and configured source registers.

GET/v1/authorities/{id}

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

Parameters

idpath · required

Opaque ID returned by the corresponding list endpoint. URL-encode the whole value.

Response 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.

registersarray

Array of the items described below.

Show item fields

idstring

Value from the collected source record.

authorityIdstring

Value from the collected source record.

namestring

Value from the collected source record.

baseUrlstring

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

platformstring

Value from the collected source record.

activeboolean

Value from the collected source record.

lastSuccessAtstring | null

Value from the collected source record.

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.