improved

02.07.24 - Demographics Category and Subcategory IDs added to Premier and Demographics APIs

Category And Subcategory ID fields are now available in demographic data in the Premier and Demographics APIs.

These ID fields act as a key-value pair with the category and subcategory name. When integrating demographic data, we recommend using the ID field as a unique identifier to prevent any potential breakpoints if category or subcategory names change.

The current category and subcategory ID and name combinations are as follows:

Category IDCategory NameSubcategory IDSubcategory Name
1Race & Ethnicity1Asian/Asian American
2Black/African American
3Hispanic/Latino/Latina/Latinx
4Native American/American Indian/Alaska Native/Indigenous
5White/Caucasian/European
6Multi-Racial/Multi-Ethnic (2+ races/ethnicities)
7Decline to state
8Unknown
27Middle Eastern/Northern African
28Native Hawaiian/Pacific Islander
1Race & Ethnicity Other9Other
2Gender Identity10Female
11Male
12Non-binary
29People who prefer to identify with another gender identity
13Decline to state
14Unknown
3Gender Identity 215Transgender
16Not transgender (cisgender)
30People who prefer to identify with another gender identity
17Decline to state
18Unknown
4Sexual Orientation19Gay, lesbian, bisexual, or other sexual orientations in the LGBTQIA+ community
20Heterosexual or straight
31People who prefer to identify with another sexual orientation
21Decline to state
22Unknown
5Disability Status23Person with a disability
24Person without a disability
25Decline to state
26Unknown

Below is an example Demographics API response with the added fields:

{
    "code": 200,
    "message": "Request was processed successfully!",
    "took": 2548,
    "errors": [],
    "data": {
        "summary": {
            "organization_name": "Candid",
            "ein": "13-1837418",
            "city": "New York City",
            "state": "NY",
            "demographics_status": "This organization has provided Candid Demographics Data on 12/06/2023",
            "demographics_status_nonprofit": "Your organization has provided Candid Demographics Data on 12/06/2023",
            "date_last_modified": "12/06/2023"
        },
        "demographics": {
            "staff_level_totals": {
                "total_board_members": "17",
                "total_staff": "190",
                "total_senior_staff": "8"
            },
            "categories": [
                {
                    "category_id": 1,
                    "category": "Race & Ethnicity",
                    "board_members_not_collected": false,
                    "staff_not_collected": false,
                    "senior_staff_not_collected": false,
                    "subcategories": [
                        {
                            "subcategory_id": 1,
                            "subcategory": "Asian/Asian American",
                            "board_members": 1,
                            "staff": 27,
                            "senior_staff": 2,
                            "reported_by_ceo": true,
                            "reported_by_coceo": null
                        },
                        {
                            "subcategory_id": 2,
                            "subcategory": "Black/African American",
                            "board_members": 4,
                            "staff": 11,
                            "senior_staff": 2,
                            "reported_by_ceo": false,
                            "reported_by_coceo": null
                        },
                        {
                            "subcategory_id": 3,
                            "subcategory": "Hispanic/Latino/Latina/Latinx",
                            "board_members": 0,
                            "staff": 14,
                            "senior_staff": null,
                            "reported_by_ceo": false,
                            "reported_by_coceo": null
                        },
                        {
                            "subcategory_id": 4,
                            "subcategory": "Native American/American Indian/Alaska Native/Indigenous",
                            "board_members": 0,
                            "staff": 0,
                            "senior_staff": null,
                            "reported_by_ceo": false,
                            "reported_by_coceo": null
                        },
                        {
                            "subcategory_id": 5,
                            "subcategory": "White/Caucasian/European",
                            "board_members": 8,
                            "staff": 86,
                            "senior_staff": 4,
                            "reported_by_ceo": false,
                            "reported_by_coceo": null
                        },
                        {
                            "subcategory_id": 6,
                            "subcategory": "Multi-Racial/Multi-Ethnic (2+ races/ethnicities)",
                            "board_members": 1,
                            "staff": 3,
                            "senior_staff": null,
                            "reported_by_ceo": false,
                            "reported_by_coceo": null
                        },
                        {
                            "subcategory_id": 7,
                            "subcategory": "Decline to state",
                            "board_members": null,
                            "staff": 7,
                            "senior_staff": null,
                            "reported_by_ceo": false,
                            "reported_by_coceo": null
                        },
                        {
                            "subcategory_id": 8,
                            "subcategory": "Unknown",
                            "board_members": 2,
                            "staff": 41,
                            "senior_staff": null,
                            "reported_by_ceo": null,
                            "reported_by_coceo": null
                        },
                        {
                            "subcategory_id": 27,
                            "subcategory": "Middle Eastern/Northern African",
                            "board_members": 0,
                            "staff": 1,
                            "senior_staff": null,
                            "reported_by_ceo": null,
                            "reported_by_coceo": null
                        },
                        {
                            "subcategory_id": 28,
                            "subcategory": "Native Hawaiian/Pacific Islander",
                            "board_members": 0,
                            "staff": 0,
                            "senior_staff": null,
                            "reported_by_ceo": null,
                            "reported_by_coceo": null
                        }
                    ]
                },
                {
                    "category_id": 1,
                    "category": "Race & Ethnicity Other",
                    "board_members_not_collected": false,
                    "staff_not_collected": false,
                    "senior_staff_not_collected": false,
                    "subcategories": [
                        {
                            "subcategory_id": 9,
                            "subcategory": "Other",
                            "board_members": 1,
                            "staff": null,
                            "senior_staff": null,
                            "reported_by_ceo": null,
                            "reported_by_coceo": null
                        }
                    ]
                },
                {
                    "category_id": 2,
                    "category": "Gender Identity",
                    "board_members_not_collected": false,
                    "staff_not_collected": false,
                    "senior_staff_not_collected": false,
                    "subcategories": [
                        {
                            "subcategory_id": 10,
                            "subcategory": "Female",
                            "board_members": 8,
                            "staff": 82,
                            "senior_staff": 5,
                            "reported_by_ceo": true,
                            "reported_by_coceo": null
                        },
                        {
                            "subcategory_id": 11,
                            "subcategory": "Male",
                            "board_members": 7,
                            "staff": 56,
                            "senior_staff": 3,
                            "reported_by_ceo": false,
                            "reported_by_coceo": null
                        },
                        {
                            "subcategory_id": 12,
                            "subcategory": "Non-binary",
                            "board_members": null,
                            "staff": 6,
                            "senior_staff": null,
                            "reported_by_ceo": false,
                            "reported_by_coceo": null
                        },
                        {
                            "subcategory_id": 29,
                            "subcategory": "People who prefer to identify with another gender identity",
                            "board_members": null,
                            "staff": null,
                            "senior_staff": null,
                            "reported_by_ceo": null,
                            "reported_by_coceo": null
                        },
                        {
                            "subcategory_id": 13,
                            "subcategory": "Decline to state",
                            "board_members": null,
                            "staff": 5,
                            "senior_staff": null,
                            "reported_by_ceo": false,
                            "reported_by_coceo": null
                        },
                        {
                            "subcategory_id": 14,
                            "subcategory": "Unknown",
                            "board_members": 2,
                            "staff": 41,
                            "senior_staff": null,
                            "reported_by_ceo": null,
                            "reported_by_coceo": null
                        }
                    ]
                },
                {
                    "category_id": 3,
                    "category": "Gender Identity 2",
                    "board_members_not_collected": false,
                    "staff_not_collected": false,
                    "senior_staff_not_collected": false,
                    "subcategories": [
                        {
                            "subcategory_id": 15,
                            "subcategory": "Transgender",
                            "board_members": 0,
                            "staff": 4,
                            "senior_staff": null,
                            "reported_by_ceo": false,
                            "reported_by_coceo": null
                        },
                        {
                            "subcategory_id": 16,
                            "subcategory": "Not transgender (cisgender)",
                            "board_members": 14,
                            "staff": 130,
                            "senior_staff": 8,
                            "reported_by_ceo": true,
                            "reported_by_coceo": null
                        },
                        {
                            "subcategory_id": 30,
                            "subcategory": "People who prefer to identify with another gender identity",
                            "board_members": null,
                            "staff": null,
                            "senior_staff": null,
                            "reported_by_ceo": null,
                            "reported_by_coceo": null
                        },
                        {
                            "subcategory_id": 17,
                            "subcategory": "Decline to state",
                            "board_members": 1,
                            "staff": 9,
                            "senior_staff": null,
                            "reported_by_ceo": false,
                            "reported_by_coceo": null
                        },
                        {
                            "subcategory_id": 18,
                            "subcategory": "Unknown",
                            "board_members": 2,
                            "staff": 47,
                            "senior_staff": null,
                            "reported_by_ceo": null,
                            "reported_by_coceo": null
                        }
                    ]
                },
                {
                    "category_id": 4,
                    "category": "Sexual Orientation",
                    "board_members_not_collected": false,
                    "staff_not_collected": false,
                    "senior_staff_not_collected": false,
                    "subcategories": [
                        {
                            "subcategory_id": 19,
                            "subcategory": "Gay, lesbian, bisexual, or other sexual orientations in the LGBTQIA+ community",
                            "board_members": null,
                            "staff": 24,
                            "senior_staff": 4,
                            "reported_by_ceo": true,
                            "reported_by_coceo": null
                        },
                        {
                            "subcategory_id": 20,
                            "subcategory": "Heterosexual or straight",
                            "board_members": 14,
                            "staff": 114,
                            "senior_staff": 4,
                            "reported_by_ceo": false,
                            "reported_by_coceo": null
                        },
                        {
                            "subcategory_id": 31,
                            "subcategory": "People who prefer to identify with another sexual orientation",
                            "board_members": null,
                            "staff": null,
                            "senior_staff": null,
                            "reported_by_ceo": null,
                            "reported_by_coceo": null
                        },
                        {
                            "subcategory_id": 21,
                            "subcategory": "Decline to state",
                            "board_members": 1,
                            "staff": 11,
                            "senior_staff": null,
                            "reported_by_ceo": false,
                            "reported_by_coceo": null
                        },
                        {
                            "subcategory_id": 22,
                            "subcategory": "Unknown",
                            "board_members": 2,
                            "staff": 41,
                            "senior_staff": null,
                            "reported_by_ceo": null,
                            "reported_by_coceo": null
                        }
                    ]
                },
                {
                    "category_id": 5,
                    "category": "Disability Status",
                    "board_members_not_collected": false,
                    "staff_not_collected": false,
                    "senior_staff_not_collected": false,
                    "subcategories": [
                        {
                            "subcategory_id": 23,
                            "subcategory": "Person with a disability",
                            "board_members": null,
                            "staff": 16,
                            "senior_staff": null,
                            "reported_by_ceo": false,
                            "reported_by_coceo": null
                        },
                        {
                            "subcategory_id": 24,
                            "subcategory": "Person without a disability",
                            "board_members": 15,
                            "staff": 120,
                            "senior_staff": 8,
                            "reported_by_ceo": true,
                            "reported_by_coceo": null
                        },
                        {
                            "subcategory_id": 25,
                            "subcategory": "Decline to state",
                            "board_members": null,
                            "staff": 7,
                            "senior_staff": null,
                            "reported_by_ceo": false,
                            "reported_by_coceo": null
                        },
                        {
                            "subcategory_id": 26,
                            "subcategory": "Unknown",
                            "board_members": 2,
                            "staff": 47,
                            "senior_staff": null,
                            "reported_by_ceo": null,
                            "reported_by_coceo": null
                        }
                    ]
                }
            ]
        }
    }
}

More information can be found in the Organizational demographic data user guide.