---
title: "/demographics/v1"
method: GET
path: "/v1/{ein}"
tags: ["v1"]
---

# /demographics/v1

`GET /v1/{ein}`

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

## Path parameters

- `ein` string, required

## Response `200`

OK

- APIResponse
  - `code` integer — HTTP response status code
  - `message` string — Diagnostic message for response status
  - `took` integer — Time taken for request to process in milliseconds
  - `errors` string[] — List of errors encountered
  - `data` Data
    - `summary` Summary
      - `organization_name` string, nullable — Organization name
      - `candid_entity_id` string — Candid internal organization ID, can be a different value than organization_id
      - `ein` string, nullable — Employee identification number
      - `city` string, nullable — Organization address city
      - `state` string, nullable — Organization address state
      - `demographics_status` string, nullable — Description of demographics status that can be displayed to a funder or donor
      - `demographics_status_nonprofit` string, nullable — Description of demographics status that can be displayed to a nonprofit
      - `date_last_modified` string, nullable — Last modified date of organization
    - `demographics` Demographics
      - `staff_level_totals` StaffLevelTotals — Demographic totals for staff
        - `total_board_members` string, nullable — Total number of board members
        - `total_staff` string, nullable — Total number of staff
        - `total_senior_staff` string, nullable — Total number of senior staff
      - `categories` Categories[], nullable — Demographic totals for staff
        - `category_id` integer — Category Id
        - `category` string, nullable
        - `board_members_not_collected` boolean, nullable — Presence of board member data collected in category
        - `staff_not_collected` boolean, nullable — Presence of staff data collected in category
        - `senior_staff_not_collected` boolean, nullable — Presence of senior staff data collected in category
        - `subcategories` SubCategories[], nullable — Subcategory descriptions
          - `subcategory_id` integer — Subcategory Id
          - `subcategory` string, nullable — Subcategory description
          - `board_members` integer, nullable — Board members in demographic group
          - `staff` integer, nullable — Staff members in demographic group
          - `senior_staff` integer, nullable — Senior staff members in demographic group
          - `reported_by_ceo` boolean, nullable — Whether or not reported by CEO
          - `reported_by_coceo` boolean, nullable — Whether or not reported by co CEO

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `406` — Not Acceptable
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.dev/candid/apis/rfpapi.md) · [All operations](https://skmtc.dev/candid/apis/rfpapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/candid/rfpapi/revisions/bb9133e46de6/schema)