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 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

  1. 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

  1. 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

  1. 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

  1. 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.

Did this page help you?