Pactman Developer Resources · Nonprofit verification answers for developers and compliance teams
Home  /  Artifacts  /  How to Verify Whether a Revoked Nonprofit Has Been Reinstated
Artifact · Developer How-To

How to Verify Whether a Revoked Nonprofit Has Been Reinstated

Use Pactman Nonprofit Check Plus API to review `revocation_date` together with `reinstatement_date`. The supplied mapping defines `revocation_date` as the date of revocation and `reinstatement_date` as the date of reinstatement, if any. Preserve `revocation_code` as Automatic Revocation file context, then review BMF, Pub. 78 and source dates separately when your workflow needs a current-status decision.

Updated September 28, 20266 min readFor developers, compliance teams, grantmaking platforms & fintech and nonprofit software teams

Direct answer

To verify whether a revoked nonprofit has been reinstated, review revocation_date together with reinstatement_date.

The supplied mapping defines revocation_date as the date of revocation and reinstatement_date as the date of reinstatement, if any. If your response contains both values, preserve both events and compare their chronology. Keep revocation_code, BMF, Pub. 78 and source freshness as separate supporting signals.

  1. Normalize the EIN.
  2. Send the EIN to the Nonprofit Check Plus API.
  3. Confirm the organization.
  4. Confirm revocation history. Review revocation_code and revocation_date.
  5. Check for reinstatement. Review reinstatement_date.
  6. Compare event dates. Preserve chronology instead of overwriting the revocation event.
  7. Review BMF presence. Check bmf_status.
  8. Review Pub. 78 presence. Check pub78_verified.
  9. Check freshness. Review most_recent_bmf, most_recent_pub78 and organization_info_last_modified.
  10. Apply your current-status policy. Distinguish historical revocation from later reinstatement.

Example request(s)

curl --request GET \
  --url https://entities.pactman.org/api/entities/nonprofitcheck/v1/us/ein/YOUR_EIN \
  --header 'Authorization: Bearer YOUR_API_KEY'

Implementation note: The endpoint name above reflects the Pactman single-EIN Nonprofit Check endpoint used in Pactman's Production/Customer Environment.

curl --request POST \
  --url https://entities.pactman.org/api/entities/nonprofitcheckbulk/v1/us/eins \
  --header 'accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '[
    "YOUR_EIN_1",
    "YOUR_EIN_2",
    "YOUR_EIN_3",
    "YOUR_EIN_4",
    "YOUR_EIN_5"
  ]'

Implementation note: The endpoint name above reflects the Pactman bulk-EIN Nonprofit Check endpoint used in Pactman's Production/Customer Environment. You can have at most 50 EINs in a bulk-EIN Nonprofit Check endpoint request.

What your application should evaluate

Signal Why it matters Typical application decision
revocation_date Identifies the revocation date, if any. Establish the revocation event in the returned history.
reinstatement_date Identifies the reinstatement date, if any. Use as the direct reinstatement-date signal.
revocation_code Provides Automatic Revocation file context. Preserve with the revocation event rather than replacing it after reinstatement.
bmf_status Indicates BMF presence. Use as separate current IRS-record context.
pub78_verified Indicates Pub. 78 presence. Use as separate contribution-list context.
Source dates most_recent_bmf, most_recent_pub78 and organization_info_last_modified provide freshness context. Use before treating the overall status as current enough for the workflow.

Example decision logic

A reinstatement workflow might:

  • require a populated revocation_date before treating the record as having known revocation history;
  • check reinstatement_date;
  • if both dates are present, preserve both and compare their order;
  • retain revocation_code;
  • review BMF and Pub. 78 separately; and
  • use source freshness before making the final current-status decision.

The supplied current examples have null revocation_date and reinstatement_date, so they do not provide a positive reinstatement example. This article therefore does not invent a sample reinstatement date.

Important: A reinstatement date should not erase the earlier revocation event in your stored data. Preserve both fields for audit and policy logic.

Why use a consolidated nonprofit verification API?

Reinstatement verification can require revocation history, reinstatement date, BMF presence, Pub. 78 presence and freshness context.

Pactman Nonprofit Check Plus returns those signals in one normalized response.

One normalized response

Evaluate revocation and reinstatement history together with supporting IRS signals.

Separate source signals

Keep revocation history, reinstatement, BMF and Pub. 78 data distinct.

Reusable compliance rules

Apply one reinstatement policy across donations, grants, onboarding and recurring reviews.

Developer-friendly automation

Verify reinstatement programmatically from an EIN instead of manually comparing multiple IRS records.

Frequently asked questions

Which Pactman field tells me the reinstatement date?

Use reinstatement_date.

Should I also keep the original revocation_date?

Yes. Preserve both fields so your application retains the full revocation/reinstatement history.

Does a reinstatement date by itself answer every current-status question?

No. Review BMF, Pub. 78 and source freshness separately when the workflow requires a broader current-status decision.

What if reinstatement_date is null?

The response contains no reinstatement date in that field. Do not invent one or infer a date that is not returned.

Next step

Compare revocation_date and reinstatement_date, preserve both events, and then apply BMF, Pub. 78 and freshness rules according to your current-status policy.

Ready to automate reinstatement checks?

Use Pactman Nonprofit Check Plus API to evaluate revocation and reinstatement history from a nonprofit EIN.

Get an API Key →