Sign in

v1

latestOpenAPI 3.0.12026-07-2427125325.2 KB
v1

/demographics/v1

Use an EIN in the path parameter to retrieve data on a nonprofit's Demographics data.

get/v1/{ein}

Path parameters

einstring required
Example:13-1837418

Employer Identification Number

Response

OK

codeinteger

HTTP response status code

messagestring

Diagnostic message for response status

tookinteger

Time taken for request to process in milliseconds

errorsstring[]

List of errors encountered

Example response

{
  "code": 200,
  "message": "Request was processed successfully!",
  "took": 24,
  "data": {
    "summary": {
      "organization_name": "Candid",
      "candid_entity_id": "6908122",
      "ein": "13-1837418",
      "city": "New York City",
      "state": "NY",
      "demographics_status": "This organization has provided Candid demographics data on 06/23/2023",
      "demographics_status_nonprofit": "Your organization has provided Candid demographics data on 06/23/2023",
      "date_last_modified": "01/02/2023"
    },
    "demographics": {
      "staff_level_totals": {
        "total_board_members": "18",
        "total_staff": "195",
        "total_senior_staff": "8"
      },
      "categories": [
        {
          "category_id": 1,
          "category": "Race & Ethnicity",
          "subcategories": [
            {
              "subcategory_id": 1,
              "subcategory": "Asian/Asian American",
              "board_members": 2,
              "staff": 26,
              "senior_staff": 4
            }
          ]
        }
      ]
    }
  }
}