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
  }
}

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.