Technical Reference¶
Extension Structure Overview¶
The DEI Extension defines new fields and structures for use within 360Giving data, for the purpose of publishing data using the DEI Data Standard within a file of 360Giving grant data. It also adds a number of new codelists to validate the contents of various fields.
Some fields are used to share taxonomy and free text data collected by publishers who have implemented the DEI Data Standard. There are also fields used to share metadata, which allow publishers to provide information about how the DEI Data Standard was applied in their specific context.
The DEI Extension adds a new field called deiDetails to each grant. Inside deiDetails there are three fields: leadership, mission, and project. These represent the three application areas of the DEI Data Standard for grantmaking.
Each of the leadership, mission, and project fields has the format of a DeiApplicationArea object. This is a new object defined by the DEI Extension so that each application area and its responses have the same structure and semantics, which makes the data more consistent and simpler to publish and use. DeiApplicationArea contains fields for important metadata to represent whether a question was asked (and how), as well as for sharing the responses to these questions.
The extension structure (using JSON schema names) is as follows:
grants
(from 360Giving Data Standard)deiDetails
deiVersion
purposes
leadership
,mission
, andproject
(DeiApplicationArea
)askedStatus
(required)replyStatus
availableOptions
additionalDetails
response
taxonomyCodes
livedExperience
Geography
In the extension, the deiDetails field is optional for each grant. However, when it is included then leadership, mission, and project become required for that grant, and each of these then have a required askedStatus field.
For a publisher of data using this extension this means that:
- If there is no DEI information for the grant, you may omit the entire deiDetails field for that grant
- If there is DEI information for the grant, then you must include the deiDetails field and provide at least a value in askedStatus for each of the leadership, mission and project application areas. This is to ensure a minimum level of context required for a user to interpret the data correctly.
Schema¶
This section contains a reference for the Extension’s schema
Title | Description | Type | Required |
---|---|---|---|
DEI Details:DEI Data Standard Version | The version of the DEI Data Standard that this data uses e.g. 1.1 | string | False |
DEI Details:Purposes | The purposes of collecting this data. | string | False |
DEI Details:Leadership:Asked Status | A code referring to how this question was asked. The value for this field should be drawn from the Asked Status codelist. | string | True |
DEI Details:Leadership:Reply Status | A code referring to the status of the reply to this question. The value for this field should be drawn from the Reply Status codelist. | string | False |
DEI Details:Leadership:Available Options | Code(s) referring to options which were available when the question was asked. The value for these codes should be drawn from the Available Options codelist. | array[string] | False |
DEI Details:Leadership:Additional Details | A free text field to include any additional details or rationales that may be important to this context. | string | False |
DEI Details:Leadership:DEI Response:Taxonomy Codes | The Taxonomy Codes selected from the DEI Taxonomies. The value for these codes should be drawn from the Taxonomy Codes codelist. | array[string] | False |
DEI Details:Leadership:DEI Response:Lived Experience | A free text description of other types of lived experience that is not drawn from the Taxonomy. | string | False |
DEI Details:Leadership:DEI Response:Geography | A free text description that is not drawn from a vocabulary but instead relates to a particular geographical area. | string | False |
DEI Details:Mission:Asked Status | A code referring to how this question was asked. The value for this field should be drawn from the Asked Status codelist. | string | True |
DEI Details:Mission:Reply Status | A code referring to the status of the reply to this question. The value for this field should be drawn from the Reply Status codelist. | string | False |
DEI Details:Mission:Available Options | Code(s) referring to options which were available when the question was asked. The value for these codes should be drawn from the Available Options codelist. | array[string] | False |
DEI Details:Mission:Additional Details | A free text field to include any additional details or rationales that may be important to this context. | string | False |
DEI Details:Mission:DEI Response:Taxonomy Codes | The Taxonomy Codes selected from the DEI Taxonomies. The value for these codes should be drawn from the Taxonomy Codes codelist. | array[string] | False |
DEI Details:Mission:DEI Response:Lived Experience | A free text description of other types of lived experience that is not drawn from the Taxonomy. | string | False |
DEI Details:Mission:DEI Response:Geography | A free text description that is not drawn from a vocabulary but instead relates to a particular geographical area. | string | False |
DEI Details:Project:Asked Status | A code referring to how this question was asked. The value for this field should be drawn from the Asked Status codelist. | string | True |
DEI Details:Project:Reply Status | A code referring to the status of the reply to this question. The value for this field should be drawn from the Reply Status codelist. | string | False |
DEI Details:Project:Available Options | Code(s) referring to options which were available when the question was asked. The value for these codes should be drawn from the Available Options codelist. | array[string] | False |
DEI Details:Project:Additional Details | A free text field to include any additional details or rationales that may be important to this context. | string | False |
DEI Details:Project:DEI Response:Taxonomy Codes | The Taxonomy Codes selected from the DEI Taxonomies. The value for these codes should be drawn from the Taxonomy Codes codelist. | array[string] | False |
DEI Details:Project:DEI Response:Lived Experience | A free text description of other types of lived experience that is not drawn from the Taxonomy. | string | False |
DEI Details:Project:DEI Response:Geography | A free text description that is not drawn from a vocabulary but instead relates to a particular geographical area. | string | False |
Codelists¶
The extension adds several codelists to promote interoperability between datasets. These are all closed codelists, meaning that only values from the codelists may be used.
Asked Status¶
A codelist to declare whether DEI Data Standard questions were asked for this grant, and how.
Code | Title | Description |
---|---|---|
AS100 | Not Asked Not Applicable | Not asked because this was not applicable to this situation |
AS101 | Not Asked Historical Data | Not asked because this grant was made before any DEI process was adopted |
AS200 | Asked During The Application Process | This was asked before a decision was made to award the grant |
AS201 | Asked After The Application Process | This was asked after a decision was made to award the grant |
Available Options¶
A codelist to declare which answer options were available to the respondents.
Code | Title | Description |
---|---|---|
AO100 | Taxonomy Population Group | The respondant may select the DEI Taxonomy codes referring to Population Group |
AO101 | Taxonomy Category | The respondant may select the DEI Taxonomy codes referring to Categories within a Population Group |
AO102 | Taxonomy Subcategory | The respondant may select the DEI Taxonomy codes referring to Subcategories within a Category |
AO200 | Geography | The respondant may enter a description of the relevant geography in a field |
AO201 | Lived Experience | The respondant may enter a description of the relevant lived experience in a field |
AO300 | General | The respondant may declare that this is general and therefore not aimed at or consisting of a specific group of people |
AO301 | Prefer Not To Say | The respondant may select an option that they prefer not to say |
Reply Status¶
A codelist to declare whether a reply to DEI Data Standard questions was received or not.
Code | Title | Description |
---|---|---|
RS100 | No Reply | No reply was received |
RS200 | Reply Got | A reply was received |
RS201 | Reply was General | The reply is general and is not aimed at or does not consist of a specific group of people |
RS202 | Reply was Prefer not to say | The reply was Prefer not to say |
RS203 | Reply Got but no permissions | A reply was received but is not permitted to be shared as open data |
Taxonomy Codes¶
The authoritative source for the DEI Taxonomy codes vocabulary is the DEI Data Standard and should take precedence over all other sources of information about the DEI Taxonomy codes, including this codelist.
The DEI Extension for 360Giving creates and maintains this codelist by taking the hierarchical codes defined in the DEI Data Standard, encoding them into JSON, and then generating this codelist automatically. This is necessary to provide a machine-readable codelist to support validation.
Please see the Governance and Versioning section for more information on how we respond to updates in the DEI Standard.
Code | Title | Description |
---|---|---|
DEI010000 | Communities experiencing racial inequity | Organisations working on racial justice or supporting people from multiple communities |
DEI010100 | Black / African / Caribbean / Black British | Mixed Black/ Black British |
DEI010110 | African | |
DEI010120 | Caribbean | |
DEI010199 | Any other Black/ African/ Caribbean background | |
DEI010200 | Mixed | Mixed groups |
DEI010210 | White and Black | |
DEI010220 | White and Asian | |
DEI010299 | Any other Mixed / Multiple ethnic background | |
DEI010300 | Asian / Asian British | Mixed Asian/ Asian British |
DEI010310 | Indian | |
DEI010320 | Pakistani | |
DEI010330 | Bangladeshi | |
DEI010340 | Chinese | |
DEI010399 | Any other Asian background | |
DEI019900 | Other Group experiencing ethnic or racial inequity | |
DEI019910 | Arab | |
DEI019920 | Jewish | |
DEI019930 | Gypsy, Roma and Traveller Communities | |
DEI019999 | Any other Ethnic group | |
DEI020000 | Disabled people | Working with people across multiple disabilities |
DEI020100 | Physical Impairment | Working with people with multiple or different physical impairments |
DEI020110 | Mobility | Physical/mobility impairment, such as a difficulty using your arms or mobility issues which require you to use a wheelchair or crutches |
DEI020120 | Visual impairment/ partial sight/sight loss | Visual impairment, such as being blind or having a serious visual impairment |
DEI020130 | Hard of hearing/ deaf/ hearing loss | Hearing impairment, such as being deaf or having a serious hearing impairment |
DEI020140 | Speech impairment | Impaired ability to produce speech sounds |
DEI020200 | Mental Health | Mental health condition or experience, such as depression or psychosis or addiction that impacts people’s lives |
DEI020300 | Cognitive differences | Multiple or different cognitive differences |
DEI020310 | Learning disability | A reduced intellectual ability and difficulty with everyday activities which affects someone for their whole life, such as Down’s Syndrome |
DEI020320 | Learning difficulty | Learning difficulties such as dyslexia and ADHD |
DEI020330 | Neurodivergent | Cognitive difference such as autistic spectrum disorder where individuals are impacted by the social environment |
DEI020400 | Health | Long-standing illness or health condition, such as cancer, HIV, diabetes, chronic heart disease or epilepsy, or other rare conditions |
DEI029900 | Other | Other - An impairment, medical condition or environmental disadvantage that is not listed above |
DEI030000 | Faith | Interfaith and multi-faith groups |
DEI030100 | Catholic | People who describe their faith as Catholic or Roman Catholic |
DEI030200 | Protestant | Anglicans, Adventists, Baptists, Methodists, Pentecostals, Presbyterians, Religious Society of Friends, Reformed Churches and other Protestant denominations |
DEI030300 | Other Christian denominations | Orthodox and other denominations |
DEI030400 | Buddhist | |
DEI030500 | Hindu | |
DEI030600 | Jewish | |
DEI030700 | Muslim | |
DEI030800 | Sikh | |
DEI030900 | Atheist | |
DEI031000 | Agnostic | |
DEI039900 | Other | Other faiths and beliefs |
DEI040000 | LGBT+ People | Working with LGBT+ people with multiple identities |
DEI040100 | Bisexual people | All bisexual people |
DEI040110 | Bisexual men | |
DEI040120 | Bisexual women | |
DEI040200 | Gay men | |
DEI040300 | Lesbian/gay women | |
DEI040400 | Transgender people | All transgender people |
DEI040410 | Trans men | |
DEI040420 | Trans women | |
DEI040500 | Non-binary people | |
DEI049900 | Other | Other LGBT+ People, including queer and intersex people |
DEI050000 | Migrants | Migrants with multiple status |
DEI050100 | Asylum seekers | |
DEI050200 | Refugees | |
DEI050300 | Undocumented People | |
DEI059900 | Other Migrants | This includes other migrants with official immigration status, e.g. international students; and who are naturalised British |
DEI060000 | Older People | Typically those aged 60 and over |
DEI070000 | Children and Young People | Typically people under 26 but sometimes people under 19 |
DEI070100 | Young adults | Typically young people from 16 to 25 years of age |
DEI070200 | Young people | Typically young people from 8 to 25 |
DEI070300 | Children | Under 16 |
DEI070400 | Infants | Under 2 years of age |
DEI080000 | People who are educationally or economically disadvantaged | This will be defined by the organisation, such as children eligible for free school meals or for adults were eligible for free school meals as a child, families receiving benefits or universal credit, people who are homeless, people who did not complete formal education or otherwise considered in deprivation or poverty etc. |
DEI090000 | Women and girls | Those who identify and live as women and girls |
DEI700000 | Welsh Language Speaking | |
DEI800010 | The Protestant community | |
DEI800020 | The Catholic community | |
DEI800030 | Neither |
Getting further help
This guidance aims to support funders through the 360Giving publishing process. If you can't find the information you need or you have further questions email 360Giving Helpdesk. You can help us improve this guidance by filling out our feedback form.