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 the category.
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 and reported_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	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	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	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	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	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.