org-id Proposal
Identify an organisation
Use the org-id system to identify companies, charities and other types of organisation in data you publish or exchange
Who this is for
- Data analysts publishing data or statistics about organisations
When to use this identifier
When data relates to a specific organisation. For example, a list of organisations that are members of a network.
Why use this identifier
The identifier allows anyone create a dataset with data about an organisation to unambiguously and consistently identify the organisation. It also makes it easier for anyone using the data to identify where multiple records apply to the same organisation, and to join it to other datasets containing information about those organisations.
How to use this identifier
You should create an “org-id” for the organisation using the format described in org-id.guide. The identifier consists of two parts:
1. The Scheme
The scheme shows which list of codes you have used for the identifier. For identifying non-profit organisations in the UK, this would be something like the Charity Commission register of charities or the Companies House register of companies.
Each scheme has a unique code that identifies it, which includes a two-letter code showing which country it belongs to. The register of charities in England and Wales is identified by GB-CHC
, while the register of companies is GB-COH
.
org-id.guide contains a register of schemes used for different organisation types in different countries. Some common schemes used for identifying non-profit organisations in the UK include:
Scheme code | Scheme name |
---|---|
GB-CHC |
Register of charities in England and Wales |
GB-COH |
Register of companies |
GB-SC |
Register of charities in |
GB-NIC |
Register of charities in Northern Ireland |
GB-MPR |
Mutuals Public Register |
GB-EDU |
Register of Schools (England and Wales) |
2. The identifier
To identify the organisation within the scheme you should use the identifier associated with the organisation. So, if you have used GB-CHC
- the register of charities in England and Wales - you should use the organisations’ charity number as the identifier. If you have used GB-COH
- the register of companies - you should use the company numbers.
Note that some identifiers may need to be formatted in a particular way. For example, a company number using GB-COH
needs to have 8 digits, with leading zeroes added as necessary. So 01234567
is correct, rather than 1234567
.
Combining the two parts
To create an identifier you then combine the two parts. This can be done in a single field using a dash -
, for example GB-COH-01234567
. Or you could have separate id
and scheme
fields.
scheme | id |
---|---|
GB-COH | 01234567 |
org-id.guide also suggests that an object can be created with id
and scheme
fields:
{
"scheme": "GB-COH",
"id": "01234567"
}
Notes on identifying organisations
Note that some organisations may be identified differently through two different schemes. For example, some charities are also registered companies, and so may have charity and company numbers. And some charities can re-register with the Charity Commission when they change legal form and so have two charity numbers. Where the majority of organisations in your dataset are charities you should prefer the charity number to the company number.
Uses of data containing this identifier should expect that they may need to “normalise” the organisation identifiers. For example, they may need to check each company number to see if it has an associated charity number.
Suggested field name:
org_id
Examples in the wild
- 360Giving recommends Org ID as the preferred format for identifying organisations that have made a received grants, as part of the data standard.
- IATI uses org-id to identify organisations that have made or received international aid. The identifiers used by IATI include identifying organisations outside of the UK.
- Findthatcharity allows searching UK charities and retrieving organisation identifiers relating to them.