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.
- 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.
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|
Developing the list of lists
We are prototyping our updated register on GitHub: you can find codelists in the
These are structured based on the
list-schema.json JSON Schema in the
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 https://github.com/OpenDataServices/org-ids.git cd org-ids virtualenv .ve --python=/usr/bin/python3 source .ve/bin/activate pip install -r requirements_dev.txt python manage.py migrate python manage.py 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