Skip to main content
POST
Returns organizations in the US Internal Revenue Service’s Tax Exempt Organization Search matching an EIN or name: whether each is listed as eligible for tax-deductible contributions, any automatic revocation of its exemption and reinstatement, its Form 990-N filings, and its filed annual returns with links to the public copies. Figures from the returns are in those copies, not here.

​
Authentication

Requires x402 payment in the payment-signature header.

​
Request Body

​
string
The employer identification number, for example 53-0196605 or 530196605. An exact match that returns the full profile. An EIN is nine digits, with or without the dash.
​
string
The organization’s name, for example American Red Cross. A text match; returns a list to pick from. 2 to 100 characters.
​
string
Two-letter state code to narrow a name search; only with name. A two-letter state code.
​
integer
Most organizations to return for a name; ignored with an EIN. From 1 to 25. Defaults to 10.

​
Response (200 OK)

Top-level envelope: success (boolean) and data (object). All fields below are nested under data.
​
string
Durable job ID for audit and lookup
​
string
Job status: completed
​
string
Always company_nonprofit_status
​
object
The answer, described under Result below
​
object
Where the answer came from and when
​
boolean
true when the answer was served from OneShot’s store of earlier lookups (or its own copy of a public dataset), false when the source was asked for this call
​
string
When the record was obtained from its source, as an ISO 8601 UTC time; equals evidence.retrieved_at
​
string
The public body the data comes from. Always US Internal Revenue Service.
​
string
public when the data comes from a public body, commercial otherwise
​
string
When the lookup was made, as an ISO 8601 UTC time
​
string | null
When the source says the fact was last updated, or null when the source gives no date

​
Result

Nested under data.result.
​
integer
How many organizations matched; may be more than were returned.
​
object[]
Organizations matching a name, alphabetical; empty for an EIN.
​
string
The employer identification number, nine digits.
​
string | null
Name. null when the source gives no value.
​
string | null
A doing-business-as name, when the source lists one. null when the source gives no value.
​
string | null
City. null when the source gives no value.
​
string | null
Two-letter state code. null when the source gives no value.
​
string | null
Country. null when the source gives no value.
​
string[]
Which of the source’s lists name the organization: publication_78 (eligible for deductible gifts), auto_revocation, determination_letters, form_990n and returns.
​
object | null
The organization with the given EIN; null for a name, or when the EIN is in none of the source’s lists.
​
string
The employer identification number, nine digits.
​
string | null
Name. null when the source gives no value.
​
string | null
A doing-business-as name, when the source lists one. null when the source gives no value.
​
string | null
City. null when the source gives no value.
​
string | null
Two-letter state code. null when the source gives no value.
​
string | null
Country. null when the source gives no value.
​
string[]
Which of the source’s lists name the organization: publication_78 (eligible for deductible gifts), auto_revocation, determination_letters, form_990n and returns.
​
object | null
Present when the organization is listed as eligible to receive tax-deductible contributions; null when it is not listed.
​
string | null
The source’s deductibility code, for example PC for a public charity or PF for a private foundation. null when the source gives no value.
​
object[]
Automatic revocations of exemption for not filing, newest first; check reinstated_on before treating one as current.
​
string | null
Date the exemption was automatically revoked, YYYY-MM-DD. null when the source gives no value.
​
string | null
Date the revocation was posted, YYYY-MM-DD. null when the source gives no value.
​
string | null
Date the exemption was reinstated, YYYY-MM-DD; null when it has not been.
​
string | null
The subsection of section 501(c) the exemption was under, for example 03. null when the source gives no value.
​
object[]
The newest Form 990-N (e-Postcard) filings, at most 5, newest first.
​
integer | null
Tax year. null when the source gives no value.
​
string | null
YYYY-MM-DD. null when the source gives no value.
​
string | null
YYYY-MM-DD. null when the source gives no value.
​
boolean
True when the filer declared gross receipts normally under 50,000 dollars.
​
boolean
True when the filing says the organization has terminated.
​
object[]
The newest filed returns with public copies, at most 10, newest first.
​
string | null
The period the return covers, YYYY-MM (its last month). null when the source gives no value.
​
string | null
The form filed: 990, 990EZ, 990PF or 990T. null when the source gives no value.
​
boolean
Filed electronically.
​
string | null
Date the public copy was published, YYYY-MM-DD. null when the source gives no value.
​
string | null
The public copy of the return on the source’s site. null when the source gives no value.
See Pricing for this tool’s price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers 200.

​
Notes

  • Give exactly one of ein and name; state narrows a name search only.
  • An EIN returns profile, the organization’s full record, with total 1; profile is null and total 0 when the EIN is in none of the source’s lists. A name returns matches, a list of organizations to pick from, alphabetical, each with the EIN to call again with; profile is then null.
  • Listed in publication_78 means the organization is eligible to receive tax-deductible contributions. An organization absent from every list may still be exempt: churches need not apply, and the exempt organizations master file is not searched here.
  • A row in revocations does not mean the organization is still revoked: it may have been reinstated, so check reinstated_on. exemption_subsection is the section 501(c) subsection the exemption was under, for example 03 for a 501(c)(3).
  • form_990n_filings keeps the newest five filings and returns the newest ten, newest first; each return has the form, the period it covers and a link to its public copy. Officer names and addresses are never returned. Dates are YYYY-MM-DD; one the source writes in an unreadable form is null.
  • Results return inline. The finished job stays available at /v1/requests/{request_id}