Skip to content
Front end application for
Python HTML CSS JavaScript Shell
Branch: master
Clone or download

Latest commit

odscjames Merge pull request #225 from OpenDataServices/kd-ods-status-update
Updating status message to indicate longer hiatus
Latest commit 93ec1bf Apr 6, 2020


Type Name Latest commit message Commit time
Failed to load latest commit information.

We are creating a simple process, tool and codelist to enable data publishers and users to create and use joined up data that identifies organisations.

This involves

  • Maintaining an list of organisation identifier lists;
  • Developing a methodology for updating the list
  • Providing simple lookup tools, and guidance on choosing the best identifiers to use

The register of organisation identifier lists

An organisation identifier list is any list that contains at least an identifier, and a name, for a collection of organisations.

Building on the IATI Organisation Registration Agency codelist we are creating an updated register of organisation identifier lists.

This list will contain detailed meta-data on the nature of the identifiers provided, the coverage of identifier lists. It will provide a unique code to identify each list.

This code can be used as a prefix to create simple identifier strings, or can be used as the 'scheme' in a two-part identifier.

For example:

The code for the organisation identifier list provided by UK Companies House is 'GB-COH'. The identifier assigned to Open Data Services Co-operative Ltd in this list is '09506232'. Putting this together allows a dataset to unambiguously identify Open Data Services Co-operative Ltd as:


or in a table such as:

Organisation ID Scheme Organisation ID
GB-COH 09506232

Developing the list of lists

We are prototyping our updated register on GitHub: you can find codelists in the /codes/ directory.

These are structured based on the list-schema.json JSON Schema in the /schema/ directory.

We have imported codes from a range of sources, and have been updating these based on the process in our Researchers Handbook.

Only those entries with a "confirmed":true have been reviewed and should be relied upon. All others should be treated as provision.

Help us out

Pull requests to update any codes, or suggest new codes are welcome.

List Finder Django App


Steps to installation:

  • Clone the repository
  • Change into the cloned repository
  • Create a virtual environment (note this application uses python3)
  • Activate the virtual environment
  • Install dependencies
  • Apply migrations
  • Run the development server
git clone
cd org-ids
virtualenv .ve --python=/usr/bin/python3
source .ve/bin/activate
pip install -r requirements_dev.txt
python migrate
python runserver



The scripts in tools/ have a number of requirements.

Set-up a virtual environment to easily install these.

virtualenv --python=/usr/local/bin/python3 .ve
source .ve/bin/activate
pip install -r requirements.txt
You can’t perform that action at this time.