Premier API

We have added a Demographics status message to the response of the Premier API v3. This field will describe whether an organization has shared information about their organizational demographics with Candid.

The demographics_status field will be available in the "summary" section of the Premier API, and will have two possible responses:

"This organization has provided Candid Demographics data"
"This organization has not provided Candid Demographics data"

If the organization has provided demographics data, it can be accessed in the "demographics" section of the Premier API. If the organization has not provided demographics data, the "demographics" section will be null. More information about organizational demographics data can be found in our user guide.

Example of Demographics status field

"summary": {
    "organization_id": 6908122,
    "organization_name": "Candid",
    "ein": "13-1837418",
    "bridge_id": "",
    "address_line_1": "32 Old Slip",
    "address_line_2": "24th Floor",
    "city": "New York",
    "state": "NY",
    "zip": "10005",
    "county": "New York",
    "latitude": "40.706104",
    "longitude": "-74.008893",
    "fax": "(212)807-3677",
    "govt_registered_name": "Candid",
    "also_known_as": "The Foundation Center,  Foundation Center, GuideStar, GuideStar USA",
    "fiscal_year_end": "Dec 31",
    "fiscal_year_start": "Jan 1",
    "affiliation_code": "3",
    "affiliation_description": "Independent - This code is used if the organization is an indepenedent organization or an independent auxiliary (i.e., not affiliated with a a National, Regional, or Geographic grouping of organizations).",
    "contact_name": "Mary Steyer",
    "contact_title": "Senior Director of Communications and Brand Awareness",
    "contact_email": "[email protected]",
    "contact_phone": "212-620-4230",
    "contact_fax": "212-807-3677",
    "gs_profile_update_level": "Platinum 2023",
    "gs_profile_update_level_logo": "https://www.guidestar.org/App_Themes/MainSite2/images/ProfilePageSvgs/profile-PLATINUM2023-seal.svg",
    "deductibility_code": "1",
    "deductibility_description": "Contributions are deductible, as provided by law",
    "donation_to_ein": "13-1837418",
    "donation_to_name": "Candid",
    "areas_served_narrative": "",
    "ruling_year": "",
    "gs_public_report": "https://www.guidestar.org/profile/13-1837418",
    "gs_pro_pdf": "https://apidata.guidestar.org/premier/v1/propdf/13-1837418",
    "gs_financial_trends_analysis_pdf": "https://apidata.guidestar.org/premier/v1/ftapdf/13-1837418",
    "impact_statement": "",
    "subsection_code": "03",
    "subsection_description": "501(c)(3) Public Charity",
    "keywords": "philanthropy, data, transparency, capacity building, research, education, foundations, foundation, charitable giving, data driven decisions, nonprofits, transparency, nonprofit sector, organizational effectiveness, organizational efficiency, nonprofit information hub, Forms 990, GuideStar, Foundation Center",
    "logo_url": "https://www.guidestar.org/ViewEdoc.aspx?eDocId=8987049&approved=True",
    "mission": "Candid gets you the information you need to do good.",
    "is_national_hq": false,
    /*NEW*/"demographics_status": "This organization has provided Candid Demographic Data"
}

Want to try it out?

Request access today.

Essentials API bug fixes

We released 2 bugs fixes identified in our Essentials API:

Adjusted invalid last updated date and 500 Error message
Fixed issues with min/max ruling year and number of employees filters

Please reach out to [email protected] with any questions.