fourzerotwo-si

fourzerotwo-si Uk Geography API

UK Geography Codes: How UK areas nest: LSOA, MSOA and parish to ward, local authority, county, region and country, wards to Westminster constituencies, and name search for ONS codes.

Documentation GitHub OpenAPI

Operations 9

GET /v1/uk-geography/ward UK Geography Codes: Ward #

GET /v1/uk-geography/local-authority UK Geography Codes: Local authority #

GET /v1/uk-geography/constituency UK Geography Codes: Westminster constituency #

GET /v1/uk-geography/lsoa UK Geography Codes: LSOA #

GET /v1/uk-geography/msoa UK Geography Codes: MSOA #

GET /v1/uk-geography/parish UK Geography Codes: Parish #

GET /v1/uk-geography/region UK Geography Codes: Region #

GET /v1/uk-geography/county UK Geography Codes: County or unitary authority #

GET /v1/uk-geography/search UK Geography Codes: Find a code by name #

Specifications

⚙

OpenAPI

https://artifacts.apis.io/fourzerotwo-si/openapi/fourzerotwo-si-uk-geography-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/fourzerotwo-si:fourzerotwo-si-uk-geography-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Fourzerotwo Si Uk Geography API
  version: 1.1.0
  contact:
    url: https://fourzerotwo.si
  description: 'Operations tagged uk-geography across 2 of this provider''s published API definitions: openapi.json, fourzerotwo-si-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://fourzerotwo.si
tags:
- name: uk-geography
  description: 'UK Geography Codes: How UK areas nest: LSOA, MSOA and parish to ward, local authority, county, region and country, wards to Westminster constituencies, and name search for ONS codes.'
paths:
  /v1/uk-geography/ward:
    get:
      operationId: uk_geography__ward
      summary: 'UK Geography Codes: Ward'
      description: 'A ward''s local authority, county/unitary, region, country and Westminster constituency. Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - uk-geography
      externalDocs:
        url: https://fourzerotwo.si/apis/uk-geography/ward
      parameters:
      - name: code
        in: query
        required: true
        description: ONS ward code
        schema:
          type: string
          maxLength: 9
        example: E05009292
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: uk-geography__ward
    servers:
    - url: https://fourzerotwo.si
  /v1/uk-geography/local-authority:
    get:
      operationId: uk_geography__local_authority
      summary: 'UK Geography Codes: Local authority'
      description: 'A local authority district''s county/unitary, region and country, with all its wards and constituencies. Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - uk-geography
      externalDocs:
        url: https://fourzerotwo.si/apis/uk-geography/local-authority
      parameters:
      - name: code
        in: query
        required: true
        description: ONS local authority district code
        schema:
          type: string
          maxLength: 9
        example: E06000001
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: uk-geography__local-authority
    servers:
    - url: https://fourzerotwo.si
  /v1/uk-geography/constituency:
    get:
      operationId: uk_geography__constituency
      summary: 'UK Geography Codes: Westminster constituency'
      description: 'The wards (split wards flagged) and local authorities making up a 2024 Westminster constituency. Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - uk-geography
      externalDocs:
        url: https://fourzerotwo.si/apis/uk-geography/constituency
      parameters:
      - name: code
        in: query
        required: true
        description: ONS constituency code
        schema:
          type: string
          maxLength: 9
        example: E14001463
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: uk-geography__constituency
    servers:
    - url: https://fourzerotwo.si
  /v1/uk-geography/lsoa:
    get:
      operationId: uk_geography__lsoa
      summary: 'UK Geography Codes: LSOA'
      description: 'The ward and local authority for a 2021 Lower Layer Super Output Area. Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - uk-geography
      externalDocs:
        url: https://fourzerotwo.si/apis/uk-geography/lsoa
      parameters:
      - name: code
        in: query
        required: true
        description: ONS LSOA code
        schema:
          type: string
          maxLength: 9
        example: E01012152
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: uk-geography__lsoa
    servers:
    - url: https://fourzerotwo.si
  /v1/uk-geography/msoa:
    get:
      operationId: uk_geography__msoa
      summary: 'UK Geography Codes: MSOA'
      description: 'The wards and local authority for a 2021 Middle Layer Super Output Area. Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - uk-geography
      externalDocs:
        url: https://fourzerotwo.si/apis/uk-geography/msoa
      parameters:
      - name: code
        in: query
        required: true
        description: ONS MSOA code
        schema:
          type: string
          maxLength: 9
        example: E02002489
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: uk-geography__msoa
    servers:
    - url: https://fourzerotwo.si
  /v1/uk-geography/parish:
    get:
      operationId: uk_geography__parish
      summary: 'UK Geography Codes: Parish'
      description: 'The ward(s) and local authority for a civil parish. Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - uk-geography
      externalDocs:
        url: https://fourzerotwo.si/apis/uk-geography/parish
      parameters:
      - name: code
        in: query
        required: true
        description: ONS parish code
        schema:
          type: string
          maxLength: 9
        example: E04000253
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: uk-geography__parish
    servers:
    - url: https://fourzerotwo.si
  /v1/uk-geography/region:
    get:
      operationId: uk_geography__region
      summary: 'UK Geography Codes: Region'
      description: 'The local authority districts in an English region. Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - uk-geography
      externalDocs:
        url: https://fourzerotwo.si/apis/uk-geography/region
      parameters:
      - name: code
        in: query
        required: true
        description: ONS region code
        schema:
          type: string
          maxLength: 9
        example: E12000001
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: uk-geography__region
    servers:
    - url: https://fourzerotwo.si
  /v1/uk-geography/county:
    get:
      operationId: uk_geography__county
      summary: 'UK Geography Codes: County or unitary authority'
      description: 'The local authority districts in a county or unitary authority. Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - uk-geography
      externalDocs:
        url: https://fourzerotwo.si/apis/uk-geography/county
      parameters:
      - name: code
        in: query
        required: true
        description: ONS county/unitary code
        schema:
          type: string
          maxLength: 9
        example: E10000016
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: uk-geography__county
    servers:
    - url: https://fourzerotwo.si
  /v1/uk-geography/search:
    get:
      operationId: uk_geography__search
      summary: 'UK Geography Codes: Find a code by name'
      description: 'Search ward, local-authority, county, region, constituency or parish names for their ONS codes. Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - uk-geography
      externalDocs:
        url: https://fourzerotwo.si/apis/uk-geography/search
      parameters:
      - name: name
        in: query
        required: true
        description: Name or part of it
        schema:
          type: string
          maxLength: 80
        example: Hartlepool
      - name: type
        in: query
        required: false
        description: ward (default) | local-authority | county | region | constituency | parish
        schema:
          type: string
          maxLength: 16
        example: local-authority
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: uk-geography__search
    servers:
    - url: https://fourzerotwo.si
components:
  responses:
    PaymentRequired:
      description: x402 payment required. The body (also base64 in the PAYMENT-REQUIRED header) lists accepted payments.
      headers:
        PAYMENT-REQUIRED:
          schema:
            type: string
          description: Base64 JSON x402 v2 PaymentRequired
      content:
        application/json:
          schema:
            type: object
            properties:
              x402Version:
                type: integer
              error:
                type: string
              accepts:
                type: array
                items:
                  type: object
    Error:
      description: 400 = invalid input, 404 = not found at the source, 502 = the source failed. Never charged.
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
              charged:
                type: boolean
  securitySchemes:
    freeKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: Optional free key (fzt_…) for the free tier.
x-refined-from:
- openapi.json
- fourzerotwo-si-openapi.json