Skip to main content
POST
Look up taxpayer by EIN
Returns a single business taxpayer’s compliance summary. This is the single-taxpayer counterpart to the client-account lookup. result is null when no accessible business matches the EIN.
Status values and badges are explained in Lookup results.

Authorizations

Authorization
string
header
required

The access token obtained from the OAuth flow, sent as a Bearer credential.

Body

application/json
businessEin
string
required

Business EIN: nine digits, with dashes and spaces ignored.

Example:

"11-1111111"

Response

Lookup completed. result carries the taxpayer summary, or is null when nothing matched.

currentStatus
object
required

Compliance status plus embeddable badge graphics. Always present on a response.

result
object | null
required

The taxpayer summary, or null when nothing matched.