---
title: "/eligible/v1"
method: GET
path: "/v1/{provider}"
tags: ["eligible"]
---

# /eligible/v1

`GET /v1/{provider}`

Validate nonprofit custom eligibility status of up to 25 organizations per call.

## Path parameters

- `provider` string, required

## Query parameters

- `ein` string[], required

## Response `200`

OK

- object
  - `code` integer — HTTP response status code.
  - `message` string[] — Array of diagnostic messages
  - `took` integer — Time taken for request to process
  - `time` string — Current time of response
  - `results_count` integer — Number of valid organizations returned
  - `errors` string[] — List of errors encountered
  - `data` object[] — Array of organizations checked for their eligibility status
    - `organization_name` string — Organiation's Name
    - `ein` string — Employee identification number
    - `eligibility_status` boolean — Indicates if the organization is eligible to receive donations through the provider. True means the organization is eligible. False means the organization is ineligible.
    - `eligibility_status_message` string — States if the organization is eligible to receive donations through the provider. If the organization is ineligible, reason for ineligibility is given in addition to next course of action.
    - `eligibility_checked_date` string — The date an organization's eligibility was last checked.
    - `profile_level` string — Guidestar.org organization profile seal of transparency level
    - `profile_year` string — GuideStar seal year
    - `profile_link` string — Guidestar.org organization profile URL
    - `seal_last_modified` string — Date when Candid seal status was modified.
    - `website_url` string — Organization's website URL.
    - `subsection_code` object
      - `subsection_code` string — Subsection Codes are the codes shown under section 501(c) of the Internal Revenue Code of 1986, which define the category under which an organization may be exempt.
      - `subsection_code_description` string — Description of organization subsection code.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — No Results 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)