Skip to main content

Introduction

The Codes service is a lookup for standard code lists — UN/LOCODE today, with more lists to follow. Give it a code, get back everything it knows about that code: no scraping source websites, no parsing published spreadsheets, no keeping your own copy of a dataset up to date.

There are two ways to use it:

  • The website — search any list from your browser, no setup needed. See Using the Site.
  • The REST API — one GET per list, for your own systems. The API Reference covers authentication, endpoints, responses, and errors, and you can download the OpenAPI schema to import into Postman or a client generator.

Where to find it​

Websitecodes.cif-consulting.co.uk
APIapi.codes.cif-consulting.co.uk

Every endpoint is a read-only lookup, so there's nothing you can break — try things out directly.

Where the data comes from​

The service keeps its own copy of each list, ingested from the official source on a schedule (twice a year for UN/LOCODE, matching UNECE's publication cadence). Lookups are served from that copy, so results are fast and unaffected by the availability of the upstream source.