Organizational demographic data
How to use the organizational demographic data available in the Premier v3 API
This user guide provides specific details on how to interpret organizational demographic data.
Data structure of "categories" in the Premier v3 API
Within the operations
section of the Premier v3 API response, you'll find the start of the organizational demographics survey under the categories
array of objects. For each object in categories
array, the following concepts apply:
- A field called
category
which represents the question's category on the demographic survey. - Boolean (true/false) fields under
category
which represents whether the organization collected answers for certain groups. - An array of
subcategories
that contains detailed objects related to thecategory
. - A field called
subcategory
which represent the answers to the question's category for the groups working at the organization. - Fields under the
subcategory
which represents the total number of individuals who answered the question as true within the groups working at the organization. - Boolean fields called
reported_by_ceo
andreported_by_coceo
which represent if the CEO and CoCEO answered the question as true.
Below is a code snippet representing these fields from the Premier v3 API response.
{
"category": "Race & Ethnicity",
"board_members_not_collected": false,
"staff_not_collected": false,
"senior_staff_not_collected": false,
"subcategories": [
{
"subcategory": "Asian American/Pacific Islanders/Asian",
"board_members": 2,
"staff": 20,
"senior_staff": 2,
"reported_by_ceo": false,
"reported_by_coceo": null
},
{
"subcategory": "Black/African American/African",
"board_members": 4,
"staff": 20,
"senior_staff": 1,
"reported_by_ceo": false,
"reported_by_coceo": null
},
{
"subcategory": "Hispanic/Latino/Latina/Latinx",
"board_members": 1,
"staff": 15,
"senior_staff": null,
"reported_by_ceo": false,
"reported_by_coceo": null
},
{
"subcategory": "Native American/American Indian/Indigenous",
"board_members": 0,
"staff": 1,
"senior_staff": null,
"reported_by_ceo": false,
"reported_by_coceo": null
},
{
"subcategory": "White/Caucasian/European",
"board_members": 11,
"staff": 110,
"senior_staff": 3,
"reported_by_ceo": true,
"reported_by_coceo": null
},
{
"subcategory": "Multi-Racial/Multi-Ethnic (2+ races/ethnicities)",
"board_members": 2,
"staff": 6,
"senior_staff": 1,
"reported_by_ceo": false,
"reported_by_coceo": null
},
{
"subcategory": "Decline to state",
"board_members": null,
"staff": 5,
"senior_staff": null,
"reported_by_ceo": false,
"reported_by_coceo": null
},
{
"subcategory": "Unknown",
"board_members": null,
"staff": 42,
"senior_staff": 1,
"reported_by_ceo": false,
"reported_by_coceo": null
}
]
}
Flags identifying if the organization collected the information
The response will include boolean (true/false) fields that indicate if the organization collected information on staff, senior staff, and board members.
Depending on your eligibility requirements, you can use these fields to build workflows for automating the processing of applications, grant distribution and reporting.
Field name | Definition | Example |
---|---|---|
board_members_not_collected | If the organization did not collect board member survey results, this field will be true, and board_members will be null. If the organization did collect board member survey results, this field will be false, and you will see a number populated in board_members . If this flag is not applicable, this field will be null. | true/false/null |
staff_not_collected | If the organization did not collect staff member survey results, this field will be true, and staff will be null. If the organization did collect staff survey results, this field will be false, and you will see a number populated in staff . If this flag is not applicable, this field will be null. | true/false/null |
senior_staff_not_collected | If the organization did not collect senior staff member survey results , this field will be true, and senior_staff will be null. If the organization did collect senior staff survey results, this field will be false, and you will see a number populated in senior_staff . If this flag is not applicable, this field will be null. | true/false/null |
Subcategories representing answers to demographic questions
Subcategories represent the answers and responses of individuals. The following table lists each demographic category, the survey question asked, and the description of each subcategory.
Category | Question on survey | Subcategories in API |
---|---|---|
Race & Ethnicity | 1) How do you publicly self-identify? a. Asian American/Pacific Islander/Asian b. Black/African American/African c. Hispanic/Latino/Latina/Latinx d. Native American/American Indian/Indigenous e. White/Caucasian/European f. Multi-racial/Multi-ethnic (two or more races or ethnicities) g. Different identity (please specify) h. Decline to state | Each subcategory object represents an answer to the question and lists the number of respondents who indicated their membership to the respective category. |
Race & Ethnicity Other | Same as above | Each subcategory listed for this category represents the write-in answer when an individual answered their Race & Ethnicity as "g. Different identity (please specify)" |
Gender Identity | 2) How do you publicly self-identify? a. Female b. Male c. Gender nonbinary/Genderqueer/Gender non-conforming d. Decline to state | Each subcategory is listed with the response of who and how individuals at the organization answered |
Gender Identity 2 | 3) How do you publicly self-identify? a. Transgender b. Not transgender (cisgender) c. Decline to state | Each subcategory is listed with the response of who and how individuals at the organization answered |
Sexual orientation | 4) How do you publicly self-identify? a. Heterosexual or straight b. Gay, lesbian, bisexual (or other sexual orientations within the LGBTQIA+ community) c. Different identity (please specify) d. Decline to state | Each subcategory is listed with the response of who and how individuals at the organization answered |
Disability Status | 5) How do you publicly self-identify? a. I identify as a person with a disability b. I do not identify as a person with a disability c. Decline to state | Each subcategory is listed with the response of who and how individuals at the organization answered |
Each subcategory object will also contain fields for the number of board members, staff, and senior staff who answered that they belong to the subcategory, as well as whether the CEO and co-CEO answered that they belong to the subcategory. The following table explains these fields.
Subcategory Answers | Definition | Example |
---|---|---|
board_members | The number of board members who answered the subcategory as true | 2 |
staff | The number of staff members who answered the subcategory as true, including senior staff, CEO, and, if applicable, CoCEO | 20 |
senior_staff | The number of senior staff members who answered the subcategory as true, including CEO and CoCEO answers | 2 |
reported_by_ceo | True if the CEO identifies with the answer of this subcategory. False if the CEO does not identify with the answer of this subcategory. If not applicable, this field is null | false |
reported_by_coceo | True if the co-CEO identifies with the answer of this subcategory. False if the co-CEO does not identify with the answer of this subcategory. If not applicable, this field is null | null |
Calculating percentage totals
If you are interested in calculating the percentage of employees who answered this question among the total staff, you can use the below fields:
total_board_members
- The number of individuals on the board. This count does not include staff.total_staff
- The number of individuals who work or volunteer at the organization, including senior staff, CEO and CoCEO. This count does not include board members.total_senior_staff
- The number of senior individuals who work or volunteer at the organization, including the CEO and CoCEO. This count does not include board members.
Updated about 1 year ago