{"openapi":"3.0.0","info":{"title":"CharityCheck","version":"1.0","description":"Validate nonprofit status and eligibility of a single organization with a 100% IRS compliant charity check. Ensure charities are compliant within key databases including IRS Publication 78, IRS Business Master File, Internal Revenue Bulletin, Automatic Revocation of Exemption, and OFAC Specially Designated National list. Gather additional details to support decision making like organization type, deductibility limitations, religious organization status, revocations, and more. Download a date and timestamped charity check PDF document to archive for due diligence via the included Charity Check PDF API. "},"servers":[{"url":"https://api.candid.org/charitycheck"},{"url":"https://apidata.guidestar.org/charitycheck"}],"components":{"securitySchemes":{"apiKeyHeader":{"type":"apiKey","name":"Subscription-Key","in":"header"},"apiKeyQuery":{"type":"apiKey","name":"Subscription-Key","in":"query"}},"schemas":{"BadRequest":{"type":"object","properties":{"code":{"type":"string","description":"HTTP response status code.","example":400},"message":{"type":"string","description":"Diagnostic message for response status","example":"The request cannot be fulfilled due to bad syntax."}}},"Unauthorized":{"type":"object","properties":{"code":{"type":"string","description":"HTTP response status code.","example":401},"message":{"type":"string","description":"Diagnostic message for response status","example":"Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API."}}},"Forbidden":{"type":"object","properties":{"code":{"type":"string","description":"HTTP response status code.","example":403},"message":{"type":"string","description":"Diagnostic message for response status","example":"Forbidden, we found insufficient permissions to grant access to the resources. Please check the detailed message of the response."}}},"NotFound":{"type":"object","properties":{"code":{"type":"string","description":"HTTP response status code.","example":404},"message":{"type":"string","description":"Diagnostic message for response status","example":"Request was processed successfully but we could not find the resource ein"}}},"NotAcceptable":{"type":"object","properties":{"code":{"type":"string","description":"HTTP response status code.","example":406},"message":{"type":"string","description":"Diagnostic message for response status","example":"The requested resource is capable of generating only content not acceptable according to the Accept headers sent in the request."}}},"TooManyRequests":{"type":"object","properties":{"code":{"type":"string","description":"HTTP response status code.","example":429},"message":{"type":"string","description":"Diagnostic message for response status","example":"Rate limit is exceeded. Try again later."}}},"InternalServerError":{"type":"object","properties":{"code":{"type":"string","description":"HTTP response status code.","example":500},"message":{"type":"string","description":"Diagnostic message for response status","example":"Oh no!, this is bad, something went wrong... please contact API support!"}}}}},"security":[{"apiKeyHeader":[]},{"apiKeyQuery":[]}],"paths":{"/v1/{ein}":{"get":{"summary":"/charitycheck/v1","description":"Validate nonprofit status and eligibility with a 100% IRS-compliant charity check.","operationId":"charitycheck_v1","parameters":[{"name":"ein","x-global":true,"in":"path","description":"Employer Identification Number.","example":"13-1837418","required":true,"schema":{"type":"string","default":"13-1837418"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP response status code.","example":200},"message":{"type":"string","description":"Diagnostic message for response status","example":"OK"},"took":{"type":"integer","description":"Time taken for request to process","example":10},"errors":{"type":"array","description":"List of errors encountered","items":{"type":"object","properties":{"resource":{"type":"string","example":""},"reason":{"type":"string","example":""}}}},"data":{"type":"object","properties":{"organization_id":{"type":"string","description":"A unique number identifying organizations and organizational entities.","example":"6908122"},"organization_info_last_modified":{"type":"string","description":"Date the organization's information was last updated.","example":"4/15/2021 12:22:44 PM"},"ein":{"type":"string","description":"Employer Identification Number.","example":"13-1837418"},"organization_name":{"type":"string","description":"The public name recognized by the IRS.","example":"Candid"},"organization_name_aka":{"type":"string","description":"Organization name \"Also Known As\" ","example":"The Foundation Center,  Foundation Center, GuideStar, GuideStar USA"},"address_line1":{"type":"string","description":"Address of the organization.","example":"32 Old Slip"},"address_line2":{"type":"string","description":"Additional address information.","example":"24th Floor"},"city":{"type":"string","description":"City of the organization's address. ","example":"New York"},"state":{"type":"string","description":"State (Abbreviation) of the organization's address.","example":"NY"},"state_name":{"type":"string","description":"State (Full Name) of the organization's address.","example":"New York"},"zip":{"type":"string","description":"Zip code of the organization's address.","example":"10005"},"filing_req_code":{"type":"string","description":"This indicates the primary return(s) the organization is required to file.","example":"010"},"charity_check_last_modified":{"type":"string","description":"Date the Charity Check report was last modified.","example":"4/15/2021 12:19:28 PM"},"pub78_church_message":{"type":"string","description":"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.","example":"This organization is a church or religious organization. Churches and religious organizations qualify for exemption from federal income tax under IRC Section 501(c)(3) and are generally eligible to receive tax-deductible contributions."},"pub78_organization_name":{"type":"string","description":"Organization name as it appears in the Publication 78 data.","example":"Candid"},"pub78_ein":{"type":"string","description":"EIN (Employer Identification Number) as it appears in the Publication 78 data. ","example":"13-1837418"},"pub78_verified":{"type":"string","description":"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. ","example":"True"},"pub78_city":{"type":"string","description":"City of the organization as it appears in the Publication 78 data.","example":"New York"},"pub78_state":{"type":"string","description":"State of the organization as it appears in the Publication 78 data.","example":"NY"},"pub78_indicator":{"type":"string","description":"Indicator for understanding an organization's Publication 78 data. Subordinate organizations in group exemptions inherit the Pub78 status of the parent organization.","example":"0"},"organization_types":{"type":"array","items":{"type":"object","properties":{"organization_type":{"type":"string","description":"Type of organization and use of contribution as it appears in the Publication 78.","example":"A public charity (50% deductibility limitation)."},"deductibility_limitation":{"type":"string","description":"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.","example":"50%"},"deductibility_status_description":{"type":"string","description":"Deductibility Status Codes.","example":"PC"}}}},"most_recent_pub78":{"type":"string","description":"Date of most recent Publication 78.","example":"4/13/2021 4:00:00 AM"},"most_recent_irb":{"type":"string","description":"Date of the most recent Internal Revenue Bulletin.","example":"4/26/2021 12:00:00 AM"},"bmf_church_message":{"type":"string","description":"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.","example":"This organization is a church or religious organization. Churches and religious organizations qualify for exemption from federal income tax under IRC Section 501(c)(3) and are generally eligible to receive tax-deductible contributions."},"bmf_organization_name":{"type":"string","description":"Organization name as it appears in the Business Master File.","example":"CANDID"},"bmf_ein":{"type":"string","description":"EIN (Employer Identification Number) as it appears in the Business Master File.","example":"13-1837418"},"bmf_status":{"type":"string","description":"If the organization appears in the Business Master File.","example":"True"},"most_recent_bmf":{"type":"string","description":"Date of the most recent IRS Business Master File.","example":"4/12/2021 4:00:00 AM"},"bmf_subsection":{"type":"string","description":"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. ","example":"03"},"subsection_description":{"type":"string","description":"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.","example":"501(c)(3) Public Charity"},"foundation_code":{"type":"string","description":"Organizations can select IRS foundation codes to describe their organization type.","example":"15"},"foundation_code_description":{"type":"string","description":"Textual description of the foundation code. ","example":"Organization which receives a substantial part of its support from a governmental unit or the general public"},"ruling_month":{"type":"string","description":"This is the month on a ruling or determination letter recognizing the organization's exempt status.","example":"06"},"ruling_year":{"type":"string","description":"This is the year on a ruling or determination letter recognizing the organization's exempt status.","example":"1957"},"adv_ruling_month":{"type":"string","description":"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.","example":"00"},"adv_ruling_year":{"type":"string","description":"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. ","example":"0000"},"group_exemption":{"type":"string","description":"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.","example":"0000"},"exempt_status_code":{"type":"string","description":"The EO Status Code defines the type of exemption held by the organization.","example":"01"},"ofac_status":{"type":"string","description":"Indicates whether this organization has been listed by OFAC on the Specially Designated National (SDN) List. Also known as the “Terrorist Watch List”. ","example":"This organization was not included in the Office of Foreign Assets Control Specially Designated Nationals(SDN) list."},"revocation_code":{"type":"string","description":"Indicates the revocation code provided by the IRS in the Automatic Revocation file.","example":"F"},"revocation_date":{"type":"string","description":"Date of revocation.","example":"1/12/2021 2:23:09 PM"},"reinstatement_date":{"type":"string","description":"Date of reinstatement, if any.","example":"1/12/2021 2:23:09 PM"},"irs_bmf_pub78_conflict":{"type":"string","description":"Indicates whether the Business Master File and Publication 78 data are reporting the organization differently regarding its classification as a private foundation. ","example":"False"},"foundation_509a_status":{"type":"string","description":"Non-private foundation status. ","example":"Section 509(a)(1) organization as referred to in Section 170(b)(1)(A)(vi)"},"irb_organization_id":{"type":"string","description":"Candid Internal Use Only (Removed in Future API Versions). ","example":"12345"},"bulletin_number":{"type":"string","description":"If the organization was listed in an Internal Revenue Bulletin, the bulletin number is listed here.","example":"2020-05"},"bulletin_url":{"type":"string","description":"URL link to the IRB.","example":"https://www.irs.gov/pub/irs-irbs/irb20-05.pdf"},"effective_date":{"type":"string","description":"Effective date of the IRB.","example":"1/12/2021 2:23:09 PM"},"irb_last_modified":{"type":"string","description":"The date that GuideStar IRB last modification date.","example":"1/12/2021 2:23:09 PM"},"report_date":{"type":"string","description":"Date and time the Charity Check API returned the result. Reported in Greenwich Mean Time (GMT).","example":"4/27/2021 2:23:09 PM"},"foundation_type_code":{"type":"string","description":"Organizations can select IRS foundation codes to describe their organization type. ","example":"PC"},"foundation_type_description":{"type":"string","description":"Textual description of the foundation code.","example":"Public charity described in section 509(a)(1) or (2)"},"parent_organizations":{"type":"array","items":{"type":"object","properties":{"ein":{"type":"string","description":"EIN of parent organization.","example":"13-1837418"},"organization_name":{"type":"string","description":"Name of Parent Organization.","example":"Candid"},"group_exemption":{"type":"string","description":"This is a four-digit internal number assigned to parent organizations holding group exemption letters.","example":"1234"}}}}}}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequest"}},"text/json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}},"text/json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Forbidden"}},"text/json":{"schema":{"$ref":"#/components/schemas/Forbidden"}}}},"404":{"description":"No Results Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}},"text/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotAcceptable"}},"text/json":{"schema":{"$ref":"#/components/schemas/NotAcceptable"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequests"}},"text/json":{"schema":{"$ref":"#/components/schemas/TooManyRequests"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}},"text/json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}}}}},"/v1/{state}/{ein}":{"get":{"summary":"/charitycheck/v1","description":"Check whether charitable organizations may or may not operate in California with Attorney General Registry and Franchise Tax Board data.","operationId":"charitycheck_v1_state","parameters":[{"name":"state","x-global":true,"in":"path","description":"State Name Abbreviation","example":"ca","required":true,"schema":{"type":"string","default":"ca"}},{"name":"ein","x-global":true,"in":"path","description":"Employer Identification Number.","example":"13-1837418","required":true,"schema":{"type":"string","default":"13-1837418"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP response status code.","example":200},"message":{"type":"string","description":"Diagnostic message for response status","example":"OK"},"took":{"type":"integer","description":"Time taken for request to process","example":10},"errors":{"type":"array","description":"List of errors encountered","items":{"type":"object","properties":{"resource":{"type":"string","example":""},"reason":{"type":"string","example":""}}}},"data":{"type":"object","properties":{"ein":{"type":"string","description":"Nine digit Federal Employer ID Number (Tax ID) assigned by the IRS if known by the Registry of Charitable Trusts. The dash (-) that separates the second and third digits is not contained in the data kept by the Registry of Charitable Trusts.","example":"47-3438111"},"california_entity_id":{"type":"string","description":"Secretary of state, FTB number, or organization unique identifier in California.","example":"1326"},"organization_name":{"type":"string","description":"Name of organization as registered with the Registry of Charitable Trusts and/or as recorded with the Secretary of State.","example":"1610 FOUNDATION INC."},"city":{"type":"string","description":"The city listed by the organization on registration and renewal documentation. For organizations that are not  registered, this may be the city as reported by the Secretary of State or other sources.","example":"BUENA PARK"},"state":{"type":"string","description":"The state listed by the organization on registration and renewal documents. For organizations that are not registered, this may be the state as reported by the Secretary of State or other sources.","example":"CA"},"attorney_general":{"type":"object","properties":{"ag_may_operate_or_solicit_in_ca":{"type":"string","description":"Status to determine if an organization may operate or solicit donation in California.","example":"Yes"},"ag_registry_status":{"type":"string","description":"Overall status of the organization with the Registry of Charitable Trusts. Registry status definitions are available on the Registry Verification Search Tips & Filing Definitions page.","example":"Current"},"ag_state_charity_reg_num":{"type":"string","description":"Unique alphanumeric ID assigned to registrants by the Registry of Charitable Trusts. Older Registration  Numbers may be six numbers long, many with leading zeros. Those issued since 2007 begin with 'CT' followed by seven numbers.","example":"CT0257773"},"ag_issue_date":{"type":"string","description":"The date on which the organization was approved for registration by the Registry of Charitable Trusts.","example":"2018-05-15"},"ag_last_renewal_date":{"type":"string","description":"The date on which the organization was last approved for annual renewal by the Registry of Charitable Trusts.","example":"2018-05-15"},"ag_status_set_date":{"type":"string","description":"The date on which the Registry Status was assigned to the organization by the Registry of Charitable Trusts.","example":"2018-09-12"},"ag_as_of_date":{"type":"string","description":"The date on which the CSV file was generated and the other data elements were extracted from the database  of the Registry of Charitable Trusts.","example":"2023-05-17"},"ag_source_data_conflict":{"type":"boolean","description":"Organization provided information to Candid that this is not a delinquent organization. Typically this scenario happens between data loads. Will be reset after each data load.","example":true},"ag_source_data_conflict_date":{"type":"string","description":"Date when organization provided information to Candid that this is not a delinquent organization. Typically this scenario happens between data loads. Will be reset when FTB removes the revocation.","example":"2023-05-18"},"most_recent_ag":{"type":"string","description":"Date of most recent AG list available.","example":"2023-04-19"}}},"franchise_tax_board":{"type":"object","properties":{"ftb_revocation_status":{"type":"boolean","description":"If this organization is on the Franchise Tax Board list.","example":true},"ftb_revocation_status_date":{"type":"string","description":"Date Franchise Tax Board revoked tax-exempt status.","example":"2017-03-28"},"most_recent_ftb":{"type":"string","description":"Date of most recent Franchise Tax Board list available.","example":"2023-04-19"},"ftb_source_data_conflict":{"type":"boolean","description":"\tOrganization provided information to Candid that this is\n  not a revoked organization. Typically this scenario happens\n  between data loads. Will be reset after each data load.","example":true},"ftb_source_data_conflict_date":{"type":"string","description":"Date when organization provided information to Candid that this is not a revoked organization. Typically this scenario happens between data loads. Will be reset when Franchise Tax Board removes the revocation.","example":"2023-05-17"}}}}}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequest"}},"text/json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}},"text/json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Forbidden"}},"text/json":{"schema":{"$ref":"#/components/schemas/Forbidden"}}}},"404":{"description":"No Results Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}},"text/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotAcceptable"}},"text/json":{"schema":{"$ref":"#/components/schemas/NotAcceptable"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequests"}},"text/json":{"schema":{"$ref":"#/components/schemas/TooManyRequests"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}},"text/json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}}}}}},"x-readme":{"explorer-enabled":true,"proxy-enabled":true}}