--- title: "/charitycheckbulk/v1" method: POST path: "/v1" --- # /charitycheckbulk/v1 `POST /v1` Validate nonprofit status and eligibility of up to 25 organizations at a time with a 100% IRS-compliant charity check. ## Request body - EinList - `eins` string[] ## Response `200` OK - object - `code` integer — HTTP response status code. - `message` string — Diagnostic message for response status - `took` integer — Time taken for request to process - `errors` object[] — List of errors encountered - `resource` string - `reason` string - `data` object - `organizations` object[] - `organization_id` string — A unique number identifying organizations and organizational entities. - `organization_info_last_modified` string — Date the organization’s information was last updated. - `ein` string — Employer Identification Number. - `organization_name` string — The public name recognized by the IRS. - `organization_name_aka` string — Organization name "Also Known As" - `address_line1` string — Address of the organization. - `address_line2` string — Additional address information. - `city` string — City of the organization's address. - `state` string — State (Abbreviation) of the organization's address. - `state_name` string — State (Full Name) of the organization's address. - `zip` string — Zip code of the organization's address. - `filing_req_code` string — This indicates the primary return(s) the organization is required to file. - `charity_check_last_modified` string — Date the Charity Check report was last modified. - `pub78_church_message` string — A message indicating that although the organization is not on the Pub78, their filing requirement code shows that they are a religious organization and are therefore not required to appear on the Pub78 to establish their status. - `pub78_organization_name` string — Organization name as it appears in the Publication 78 data. - `pub78_ein` string — EIN (Employer Identification Number) as it appears in the Publication 78 data. - `pub78_verified` string — Whether the organization is listed on the most current Publication 78. Also known as the Cumulative List of Organizations, IRS Publication 78 lists all organizations to which charitable contributions are tax deductible. The Publication 78 record for each organization includes the organization's name, its city, and its current tax-exempt status, including what percentage of contributions to it are tax deductible. Subordinate organizations in group exemptions inherit the Pub78 status of the parent organization. - `pub78_city` string — City of the organization as it appears in the Publication 78 data. - `pub78_state` string — State of the organization as it appears in the Publication 78 data. - `pub78_indicator` string — Indicator for understanding an organization’s Publication 78 data. Subordinate organizations in group exemptions inherit the Pub78 status of the parent organization. - `organization_types` object[] - `organization_type` string — Type of organization and use of contribution as it appears in the Publication 78. - `deductibility_limitation` string — In general, an individual who itemizes deductions may deduct contributions to most charitable organizations up to 50% of his or her adjusted gross income computed without regard to net operating loss carrybacks. Individuals generally may deduct charitable contributions to other organizations up to 30% of their adjusted gross income (computed without regard to net operating loss carrybacks). These limitations (and organizational status) are indicated. - `deductibility_status_description` string — Deductibility Status Codes. - `most_recent_pub78` string — Date of most recent Publication 78. - `most_recent_irb` string — Date of the most recent Internal Revenue Bulletin. - `bmf_church_message` string — A message indicating that although the organization is not on the IRS BF, their filing requirement code shows that they are a church or religious organization and are therefore not required to appear on the IRS BMF to establish their status. - `bmf_organization_name` string — Organization name as it appears in the Business Master File. - `bmf_ein` string — EIN (Employer Identification Number) as it appears in the Business Master File. - `bmf_status` string — If the organization appears in the Business Master File. - `most_recent_bmf` string — Date of the most recent IRS Business Master File. - `bmf_subsection` string — Subsection code as it appears in Business Master File. This code identifies the type of tax-exempt organization. This is often used to determine if contributions to them are tax deductible. - `subsection_description` string — Subsection code description as it relates to the subsection code that appears in Business Master File. This code identifies the type of tax-exempt organization. This is often used to determine if contributions to them are tax deductible. - `foundation_code` string — Organizations can select IRS foundation codes to describe their organization type. - `foundation_code_description` string — Textual description of the foundation code. - `ruling_month` string — This is the month on a ruling or determination letter recognizing the organization's exempt status. - `ruling_year` string — This is the year on a ruling or determination letter recognizing the organization's exempt status. - `adv_ruling_month` string — This is the month on an advanced ruling recognizing the organization’s exempt status. A section 501(c)(3) organization that has received an advance ruling with an expiration date on or after June 9, 2008, is classified as a publicly supported charity during its first five years. Such an organization and its donors may rely on the organization's advance ruling and the organization no longer needs to file Form 8734 with the IRS. Beginning with the organization's sixth year, it must establish that it met the public support test by showing that it is publicly supported on its Form 990, Return of Organization Exempt From Income Tax.On September 9, 2008, the IRS issued temporary Income Tax Regulations, which eliminated the advance ruling process for a section 501(c)(3) organization. Under the new regulations, a new 501(c)(3) organization will be classified as a publicly supported charity, and not a private foundation, if it can show that it reasonably can be expected to be publicly supported when it applies for tax-exempt status. - `adv_ruling_year` string — This is the year on an advanced ruling recognizing the organization’s exempt status. A section 501(c)(3) organization that has received an advance ruling with an expiration date on or after June 9, 2008, is classified as a publicly supported charity during its first five years. Such an organization and its donors may rely on the organization's advance ruling and the organization no longer needs to file Form 8734 with the IRS. Beginning with the organization's sixth year, it must establish that it met the public support test by showing that it is publicly supported on its Form 990, Return of Organization Exempt From Income Tax. On September 9, 2008, the IRS issued temporary Income Tax Regulations, which eliminated the advance ruling process for a section 501(c)(3) organization. Under the new regulations, a new 501(c)(3) organization will be classified as a publicly supported charity, and not a private foundation, if it can show that it reasonably can be expected to be publicly supported when it applies for tax-exempt status. - `group_exemption` string — This is a 4-digit IRS-internal number assigned to parent organizations holding group exemption letters. Subordinate organizations in group exemptions inherit the Pub78 status of the parent organization. - `exempt_status_code` string — The EO Status Code defines the type of exemption held by the organization. - `ofac_status` string — Indicates whether this organization has been listed by OFAC on the Specially Designated National (SDN) List. Also known as the “Terrorist Watch List”. - `revocation_code` string — Indicates the revocation code provided by the IRS in the Automatic Revocation file. - `revocation_date` string — Date of revocation. - `reinstatement_date` string — Date of reinstatement, if any. - `irs_bmf_pub78_conflict` string — Indicates whether the Business Master File and Publication 78 data are reporting the organization differently regarding its classification as a private foundation. - `foundation_509a_status` string — Non-private foundation status. - `irb_organization_id` string — Candid Internal Use Only (Removed in Future API Versions). - `bulletin_number` string — If the organization was listed in an Internal Revenue Bulletin, the bulletin number is listed here. - `bulletin_url` string — URL link to the IRB. - `effective_date` string — Effective date of the IRB. - `irb_last_modified` string — The date that GuideStar IRB last modification date. - `report_date` string — Date and time the Charity Check API returned the result. Reported in Greenwich Mean Time (GMT). - `foundation_type_code` string — Organizations can select IRS foundation codes to describe their organization type. - `foundation_type_description` string — Textual description of the foundation code. - `parent_organizations` object[] - `ein` string — EIN of parent organization. - `organization_name` string — Name of Parent Organization. - `group_exemption` string — This is a four-digit internal number assigned to parent organizations holding group exemption letters. ## 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)