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 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 nameDefinitionExample
board_members_not_collectedIf 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_collectedIf 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_collectedIf 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.

CategoryQuestion on surveySubcategories in API
Race & Ethnicity1) 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 OtherSame as aboveEach subcategory listed for this category represents the write-in answer when an individual answered their Race & Ethnicity as "g. Different identity (please specify)"
Gender Identity2) 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 23) 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 orientation4) 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 Status5) 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 AnswersDefinitionExample
board_membersThe number of board members who answered the subcategory as true2
staffThe number of staff members who answered the subcategory as true, including senior staff, CEO, and, if applicable, CoCEO20
senior_staffThe number of senior staff members who answered the subcategory as true, including CEO and CoCEO answers2
reported_by_ceoTrue 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_coceoTrue 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.