openapi: "3.1.0"
info:
  version: 18.0.0
  license:
    name: MIT
    url: "https://opensource.org/licenses/MIT"
  title: API Reference - Postcodes.io
  termsOfService: "https://postcodes.io/docs/licenses"
  description:
    $ref: "./description.md"
  contact:
    email: support@ideal-postcodes.co.uk
    name: Support
    url: https://ideal-postcodes.co.uk/support
externalDocs:
  description: More on our APIs, libraries with guides and examples
  url: "https://docs.ideal-postcodes.co.uk/postcodesio"
servers:
  - url: "https://api.postcodes.io"
    description: "API Server"
    variables: {}
tags:
  - name: Postcodes
  - name: Terminated Postcodes
  - name: Scottish Postcodes
  - name: Outward Codes
  - name: Places
x-tagGroups:
  - name: API
    tags:
      - Postcodes
      - Terminated Postcodes
      - Scottish Postcodes
      - Outward Codes
      - Places
paths:
  "/postcodes/{postcode}":
    $ref: "paths/postcodes@{postcode}.yaml"
  "/postcodes":
    $ref: "paths/postcodes.yaml"
  "/postcodes/{postcode}/nearest":
    $ref: "paths/postcodes@{postcode}@nearest.yaml"
  "/random/postcodes":
    $ref: "paths/random@postcodes.yaml"
  "/terminated_postcodes/{postcode}":
    $ref: "paths/terminated_postcodes@{postcode}.yaml"
  "/scotland/postcodes/{postcode}":
    $ref: "paths/scotland@postcodes@{postcode}.yaml"
  "/outcodes/{outcode}":
    $ref: "paths/outcodes@{outcode}.yaml"
  "/places":
    $ref: "paths/places.yaml"
  "/places/{code}":
    $ref: "paths/places@{code}.yaml"
  "/random/places":
    $ref: "paths/random@places.yaml"