Skip to main content
POST
/
taxpayers
/
lookup
/
ein
Look up taxpayer by EIN
curl --request POST \
  --url https://delegate-demo.api.taxrock.com/taxpayers/lookup/ein \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "businessEin": "<string>"
}
'
{
  "currentStatus": {
    "status": "NotCompliant",
    "badgeGraphicUrl": "https://taxrock-assets.s3.us-east-2.amazonaws.com/public/status-badges/taxrock-badge-not-compliant.svg"
  },
  "result": {
    "id": "1a2b3c4d-0000-0000-0000-000000000001",
    "name": "Acme Holdings LLC",
    "type": "Business",
    "tin": "111111111",
    "isTinCensored": false,
    "amountDue": 18000,
    "unallocatedCredits": 0,
    "numMissingReturns": 1
  }
}
Looks up the single business taxpayer with the given EIN and returns its compliance summary. The single-taxpayer counterpart to the client-account lookup. Returns 200 for any well-formed EIN. result is null when no business with that EIN is accessible to you. A missing or malformed businessEin returns 400.
Status values, badges, and tin censoring are described once in Concepts → Compliance status.

​
result fields

  • id, name, type — the matched taxpayer (type is always Business for EIN lookups).
  • tin, isTinCensored — the business EIN (uncensored for businesses).
  • amountDue, unallocatedCredits — this taxpayer’s balances. null while data is pending.
  • numMissingReturns — required returns not yet filed, within the recent lookback window. null while data is pending.
A business still being onboarded (not yet fully provisioned) still matches: it returns currentStatus.status of DataPending with null financial fields. Use the Run panel to try it: paste an access token (see the Quickstart) and send a sandbox EIN such as 11-1111111.

Authorizations

​
Authorization
string
header
required

The access token obtained from the OAuth flow (see Guides → Quickstart). Paste it here to run the endpoint.

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 an embeddable badge graphic. Always present on a response.

​
result
object
required

The taxpayer summary, or null when nothing matched.