Skip to content
Everytownland

The API

The facts of the pages, in JSON. No key, no quota, no account. Paths and field names are in English; the values stay as the sources publish them.

Addresses

8 addresses, each with a live example

The OpenAPI 3.1 contract, generated from the code that serves these addresses: https://everytownland.com/api/openapi.json. Every response carries a Link header to it and to this page.

Responses

Stability

Errors

application/problem+json, RFC 9457

An error carries no envelope and is served with no-store. Its type is one of the anchors below; instance is the path asked for, and received what was read.

county-not-found 404
The county is not one of the 26 of the Republic of Ireland.
townland-not-found 404
No townland of the county bears that name or segment. When the county bears the name several times, candidates lists each homonym with its address.
street-not-found 404
No street or estate of the county with five sales or more bears that name or segment. A name alone the county carries in several localities lists each in candidates, with its address.
civil-parish-not-found 404
No civil parish of the county bears that name or segment; candidates as for a townland.
invalid-parcel-id 400
The parcel id is not a Tailte Éireann number: digits only.
parcel-not-found 404
No registered freehold parcel carries that number. Parcels are renumbered when a title is split or merged.
invalid-position 400
The lon or lat parameter is missing, or is not a number in WGS 84 degrees.
invalid-query 400
The q parameter is missing or shorter than two characters.
source-unavailable 503
Tailte Éireann did not answer. This says nothing about the parcel or the position asked for: retry after the retry-after seconds.
method-not-allowed 405
The method is not GET, HEAD or OPTIONS. The response carries Allow.
not-found 404
Nothing is served at this address under /api/.
rate-limited 429
More than 30 requests in a minute from the same address on /api/ or the MCP server. retry-after says how long to wait.

Markdown twins and MCP

Citing

Tailte Éireann, the Department of Housing, Local Government and Heritage and the heritage services publish under CC BY 4.0; the Residential Property Price Register is re-used with the source acknowledged. The source field of each response is the sentence to copy.