{"openapi":"3.0.0","info":{"title":"NonprofitCheck Plus API v1.0","description":"\n

This is the developer documentation for the Nonprofit Check Plus API v1.0. Here you will find information about authentication, error handling and other important details about the Nonprofit Check Plus API.

\n

You can find out more about the NonprofitCheck Plus API at www.pactman.org. Power your websites and applications with Pactman’s comprehensive nonprofit data. Protect your reputation by avoiding the risk of supporting ineligible nonprofits.

\n Some useful links:\n

Get API Account\n
Pricing\n
Code Snippet\n
Comparison to Competitors\n
Frequently Asked Questions\n
Terms of Service\n
Data mapping document (NonprofitCheck API)\n\n

Authentication

\n
Pactman.org expects all API requests to be authenticated.
\n

Every call should include a header that looks like the following:\n \n \n \n \n \n \n \n \n \n \n \n \n \n
HTTP HeaderValue
AuthorizationYour Bearer token
\n
When you request an API key you will receive 1 API key\n

Example API Key:\n

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJmcmVlX2VpbnMiOiI5OTY1ODk1NjAsIDk5NjIwMjY3NiwgOTk2MTMxMjU0LCA5OTYxMDM3OTAsIDY4MDM0MzEyNSJ9._Oj_MfyeAZnPkOZvx2xhsItr00D7HkFKIc50aMfslQU

\n

The API key listed here is only a demo API key and has limited use: it can be used with these EINs: 996589560, 996202676, 996131254, 996103790, 680343125

\n

Feel free to request an API key using the link above

\n

Note - If using your own API key, please use the Authorize button below to set your API key before using either the NonprofitCheck or NonprofitCheckBulk methods.

\n","version":"1.0","contact":{}},"servers":[{"url":"https://entities.pactman.org","description":"Pactman Entities Production API"}],"tags":[{"name":"NonprofitCheck","description":"Charity Check on a specific Nonprofit"},{"name":"NonprofitCheckBulk","description":"Charity Check on a list of Nonprofits"}],"paths":{"/api/entities/nonprofitcheck/v1/us/ein/{ein}":{"get":{"operationId":"checkNonprofitByEin","summary":"Lookup nonprofit by EIN","tags":["NonprofitCheck"],"parameters":[{"name":"ein","required":true,"in":"path","description":"9 digit IRS Employer Identification Number","example":"996589560","schema":{"type":"string","pattern":"^[0-9]{9}$"}}],"responses":{"200":{"description":"Successful nonprofit lookup","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleNonprofitResponse"},"examples":{"example":{"value":{"code":200,"message":"OK","errors":null,"data":{"pactman_org_url":"https://pactman.org/profile/nonprofit/aborjaily-example-nonprofit-r5U9r8yRcZ","organization_info_last_modified":"2/22/2026 1:16:30 AM","ein":"555555555","organization_name":"ABORJAILY EXAMPLE NONPROFIT","organization_name_aka":"ABORJAILY E.N","address_line1":"50 LOWELL AVE","address_line2":"APT 3B","city":"WESTFIELD","state":"MA","state_name":"Massachusetts","zip":"01085-2643","filing_req_code":"00","pub78_church_message":null,"pub78_organization_name":"Aborjaily Example Nonprofit","pub78_ein":"555555555","pub78_verified":true,"pub78_city":"Westfield","pub78_state":"MA","pub78_indicator":"0","organization_types":[{"organization_type":"Deductions for donations to public charities are generally limited to 50 percent of adjusted gross income (AGI). This limit increases to 60% of AGI for cash donations. For Non-Cash assets held for more than one year, the limit is 30% of AGI.","deductibility_limitation":"50%","deductibility_status_description":"PC"}],"most_recent_pub78":"12/12/2025 12:00:00 AM","bmf_church_message":null,"bmf_organization_name":"ABORJAILY EXAMPLE NONPROFIT","bmf_ein":"555555555","bmf_status":true,"most_recent_bmf":"12/09/2025 12:00:00 AM","bmf_subsection":"03","subsection_description":"501(c)(3) Public Charity","foundation_code":"10","foundation_code_description":"Public charity described in section 509(a)(1) or (2)","ruling_month":"07","ruling_year":"2024","group_exemption":"0000","exempt_status_code":"01","ofac_status":"This organization was NOT included in the Office of Foreign Assets Control Specially Designated Nationals (SDN) list.","revocation_code":"01","revocation_date":"3/06/2026 9:41:03 PM","reinstatement_date":"3/07/2026 9:41:03 PM","irs_bmf_pub78_conflict":false,"foundation_509a_status":"N/A","report_date":"3/25/2026 3:28:54 PM","foundation_type_code":"pc","foundation_type_description":"Public charity described in section 509(a)(1) or (2)"},"timeTaken":3,"nonprofit_check_count":1}}}}}},"400":{"description":"Invalid EIN","content":{"application/json":{"example":{"code":400,"message":"Invalid EIN format","errors":"EIN must contain 9 digits"}}}},"401":{"description":"Unauthorized"},"404":{"description":"A nonprofit with this EIN does not exist in our records"},"500":{"description":"Internal Server Error"}},"security":[{"Nonprofit Check JWT":[]}]}},"/api/entities/nonprofitcheckbulk/v1/us/eins":{"post":{"operationId":"checkNonprofitsBulk","summary":"Bulk nonprofit lookup","tags":["NonprofitCheckBulk"],"parameters":[],"requestBody":{"required":true,"description":"Array of EIN numbers (maximum 50)","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}},"examples":{"bulkEins":{"summary":"Example EINs","description":"Array of nonprofit EIN numbers","value":["996589560","996202676","996131254","996103790","680343125"]}}}}},"responses":{"200":{"description":"Bulk nonprofit lookup successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkNonprofitResponse"},"examples":{"example":{"value":{"code":200,"message":"OK","errors":null,"data":[{"pactman_org_url":"https://pactman.org/profile/nonprofit/meals-today-example-nonprofit-r5U9r8yRcZ","organization_info_last_modified":"2/22/2026 1:16:30 AM","ein":"888888888","organization_name":"MEALS TODAY EXAMPLE NONPROFIT","organization_name_aka":"MEALS TODAY E.N","address_line1":"50 LOWELL AVE","address_line2":"APT 3B","city":"WESTFIELD","state":"MA","state_name":"Massachusetts","zip":"01085-2643","filing_req_code":"00","pub78_church_message":null,"pub78_organization_name":"Meals Today Example Nonprofit","pub78_ein":"888888888","pub78_verified":true,"pub78_city":"Westfield","pub78_state":"MA","pub78_indicator":"0","organization_types":[{"organization_type":"Deductions for donations to public charities are generally limited to 50 percent of adjusted gross income (AGI). This limit increases to 60% of AGI for cash donations. For Non-Cash assets held for more than one year, the limit is 30% of AGI.","deductibility_limitation":"50%","deductibility_status_description":"PC"}],"most_recent_pub78":"12/12/2025 12:00:00 AM","bmf_church_message":null,"bmf_organization_name":"MEALS TODAY EXAMPLE NONPROFIT","bmf_ein":"888888888","bmf_status":true,"most_recent_bmf":"12/09/2025 12:00:00 AM","bmf_subsection":"03","subsection_description":"501(c)(3) Public Charity","foundation_code":"10","foundation_code_description":"Public charity described in section 509(a)(1) or (2)","ruling_month":"07","ruling_year":"2024","group_exemption":"0000","exempt_status_code":"01","ofac_status":"This organization was NOT included in the Office of Foreign Assets Control Specially Designated Nationals (SDN) list.","revocation_code":"01","revocation_date":"2/06/2022 9:41:03 PM","reinstatement_date":"3/07/2024 9:41:03 PM","irs_bmf_pub78_conflict":false,"foundation_509a_status":"N/A","report_date":"3/25/2026 3:28:54 PM","foundation_type_code":"pc","foundation_type_description":"Public charity described in section 509(a)(1) or (2)"},{"pactman_org_url":"https://pactman.org/profile/nonprofit/aborjaily-example-nonprofit-r5U9r8yRcZ","organization_info_last_modified":"2/22/2026 1:16:30 AM","ein":"555555555","organization_name":"ABORJAILY EXAMPLE NONPROFIT","organization_name_aka":"ABORJAILY E.N","address_line1":"50 LOWELL AVE","address_line2":"APT 3B","city":"WESTFIELD","state":"MA","state_name":"Massachusetts","zip":"01085-2643","filing_req_code":"00","pub78_church_message":null,"pub78_organization_name":"Aborjaily Example Nonprofit","pub78_ein":"555555555","pub78_verified":true,"pub78_city":"Westfield","pub78_state":"MA","pub78_indicator":"0","organization_types":[{"organization_type":"Deductions for donations to public charities are generally limited to 50 percent of adjusted gross income (AGI). This limit increases to 60% of AGI for cash donations. For Non-Cash assets held for more than one year, the limit is 30% of AGI.","deductibility_limitation":"50%","deductibility_status_description":"PC"}],"most_recent_pub78":"12/12/2025 12:00:00 AM","bmf_church_message":null,"bmf_organization_name":"ABORJAILY EXAMPLE NONPROFIT","bmf_ein":"555555555","bmf_status":true,"most_recent_bmf":"12/09/2025 12:00:00 AM","bmf_subsection":"03","subsection_description":"501(c)(3) Public Charity","foundation_code":"10","foundation_code_description":"Public charity described in section 509(a)(1) or (2)","ruling_month":"07","ruling_year":"2024","group_exemption":"0000","exempt_status_code":"01","ofac_status":"This organization was NOT included in the Office of Foreign Assets Control Specially Designated Nationals (SDN) list.","revocation_code":null,"revocation_date":null,"reinstatement_date":null,"irs_bmf_pub78_conflict":false,"foundation_509a_status":"N/A","report_date":"3/25/2026 3:28:54 PM","foundation_type_code":"pc","foundation_type_description":"Public charity described in section 509(a)(1) or (2)"}],"timeTaken":39,"nonprofit_check_count":2}}}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"404":{"description":"There are no matching nonprofits in our records for this set of EINs"},"500":{"description":"Internal Server Error"}},"security":[{"Nonprofit Check Bulk JWT":[]}]}}},"components":{"securitySchemes":{"Nonprofit Check JWT":{"scheme":"bearer","bearerFormat":"JWT","type":"http","name":"JWT","description":"JWT token for the NonprofitCheck API","in":"header"},"Nonprofit Check Bulk JWT":{"scheme":"bearer","bearerFormat":"JWT","type":"http","name":"JWT","description":"JWT token for the NonprofitCheckBulk API","in":"header"}},"schemas":{"BulkEinRequest":{"type":"array","maxItems":50,"items":{"type":"string","pattern":"^[0-9]{9}$"}},"OrganizationType":{"type":"object","properties":{"organization_type":{"type":"string"},"deductibility_limitation":{"type":"string"},"deductibility_status_description":{"type":"string"}}},"Nonprofit":{"type":"object","properties":{"pactman_org_url":{"type":"string","nullable":true},"organization_info_last_modified":{"type":"string","nullable":true},"ein":{"type":"string"},"organization_name":{"type":"string","nullable":true},"organization_name_aka":{"type":"string","nullable":true},"address_line1":{"type":"string","nullable":true},"address_line2":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"state":{"type":"string","nullable":true},"state_name":{"type":"string","nullable":true},"zip":{"type":"string","nullable":true},"filing_req_code":{"type":"string","nullable":true},"pub78_organization_name":{"type":"string","nullable":true},"pub78_church_message":{"type":"string","nullable":true},"pub78_ein":{"type":"string","nullable":true},"most_recent_pub78":{"type":"string","nullable":true},"pub78_city":{"type":"string","nullable":true},"pub78_state":{"type":"string","nullable":true},"pub78_indicator":{"type":"string","nullable":true},"pub78_verified":{"type":"boolean","nullable":true},"bmf_church_message":{"type":"string","nullable":true},"bmf_organization_name":{"type":"string","nullable":true},"bmf_ein":{"type":"string","nullable":true},"bmf_status":{"type":"boolean","nullable":true},"most_recent_bmf":{"type":"string","nullable":true},"bmf_subsection":{"type":"string","nullable":true},"subsection_description":{"type":"string","nullable":true},"foundation_code":{"type":"string","nullable":true},"foundation_code_description":{"type":"string","nullable":true},"ruling_month":{"type":"string","nullable":true},"ruling_year":{"type":"string","nullable":true},"group_exemption":{"type":"string","nullable":true},"exempt_status_code":{"type":"string","nullable":true},"ofac_status":{"type":"string","nullable":true},"revocation_code":{"type":"string","nullable":true},"revocation_date":{"type":"string","nullable":true},"reinstatement_date":{"type":"string","nullable":true},"irs_bmf_pub78_conflict":{"type":"boolean","nullable":true},"foundation_509a_status":{"type":"string","nullable":true},"report_date":{"type":"string"},"foundation_type_code":{"type":"string","nullable":true},"foundation_type_description":{"type":"string","nullable":true},"organization_types":{"type":"array","items":{"$ref":"#/components/schemas/OrganizationType"}}}},"SingleNonprofitResponse":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"},"errors":{"type":"string","nullable":true},"data":{"$ref":"#/components/schemas/Nonprofit"},"timeTaken":{"type":"integer"},"nonprofit_check_count":{"type":"integer"}}},"BulkNonprofitResponse":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"},"errors":{"type":"string","nullable":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/Nonprofit"}},"timeTaken":{"type":"integer"},"nonprofit_check_count":{"type":"integer","nullable":true}}}}}}