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": "11-1111111"
}
'import requests
url = "https://delegate-demo.api.taxrock.com/taxpayers/lookup/ein"
payload = { "businessEin": "11-1111111" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({businessEin: '11-1111111'})
};
fetch('https://delegate-demo.api.taxrock.com/taxpayers/lookup/ein', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://delegate-demo.api.taxrock.com/taxpayers/lookup/ein",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'businessEin' => '11-1111111'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://delegate-demo.api.taxrock.com/taxpayers/lookup/ein"
payload := strings.NewReader("{\n \"businessEin\": \"11-1111111\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://delegate-demo.api.taxrock.com/taxpayers/lookup/ein")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"businessEin\": \"11-1111111\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://delegate-demo.api.taxrock.com/taxpayers/lookup/ein")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"businessEin\": \"11-1111111\"\n}"
response = http.request(request)
puts response.read_body{
"currentStatus": {
"status": "NotCompliant",
"badgeGraphicUrl": "https://taxrock-assets.s3.us-east-2.amazonaws.com/public/status-badges/taxrock-badge-not-compliant.svg",
"badgeGraphicUrlDark": "https://taxrock-assets.s3.us-east-2.amazonaws.com/public/status-badges/taxrock-badge-not-compliant-dark.svg"
},
"result": {
"id": "1a2b3c4d-0000-0000-0000-000000000001",
"name": "Acme Holdings LLC",
"type": "Business",
"tin": "111111111",
"isTinCensored": false,
"amountDue": 18000,
"unallocatedCredits": 0,
"numMissingReturns": 1,
"balanceByYear": [
{
"year": 2023,
"principal": 14000,
"interest": 2600,
"penalties": 1400,
"allCredits": 0,
"unallocatedCredits": 0,
"amountDue": 18000
}
],
"lienSummary": {
"hasActiveLienSecuringNonZeroBalance": true,
"totalBalanceSecuredByLiens": 18000,
"mostRecentActiveLienFilingDate": "2024-05-14T00:00:00Z"
},
"installmentAgreementSummary": {
"hasBalanceNotCoveredByActiveIA": true,
"balanceNotCoveredByActiveIA": 18000,
"periodsNotCoveredByActiveIA": [
{
"formName": "1120",
"taxYear": 2023,
"taxPeriod": 0
}
]
},
"liens": [
{
"id": "3c4d5e6f-0000-0000-0000-000000000001",
"status": "Active",
"filingDate": "2024-05-14T00:00:00Z",
"currentSecuredBalance": 18000,
"securedPeriods": [
{
"formName": "1120",
"taxYear": 2023,
"taxPeriod": 0
}
],
"fullyRemovedDate": null,
"balanceAtRemoval": null
}
],
"installmentAgreements": []
}
}Compliance Lookup
Look up taxpayer by EIN
Looks up the single business taxpayer with the given EIN and returns its compliance summary.
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": "11-1111111"
}
'import requests
url = "https://delegate-demo.api.taxrock.com/taxpayers/lookup/ein"
payload = { "businessEin": "11-1111111" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({businessEin: '11-1111111'})
};
fetch('https://delegate-demo.api.taxrock.com/taxpayers/lookup/ein', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://delegate-demo.api.taxrock.com/taxpayers/lookup/ein",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'businessEin' => '11-1111111'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://delegate-demo.api.taxrock.com/taxpayers/lookup/ein"
payload := strings.NewReader("{\n \"businessEin\": \"11-1111111\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://delegate-demo.api.taxrock.com/taxpayers/lookup/ein")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"businessEin\": \"11-1111111\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://delegate-demo.api.taxrock.com/taxpayers/lookup/ein")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"businessEin\": \"11-1111111\"\n}"
response = http.request(request)
puts response.read_body{
"currentStatus": {
"status": "NotCompliant",
"badgeGraphicUrl": "https://taxrock-assets.s3.us-east-2.amazonaws.com/public/status-badges/taxrock-badge-not-compliant.svg",
"badgeGraphicUrlDark": "https://taxrock-assets.s3.us-east-2.amazonaws.com/public/status-badges/taxrock-badge-not-compliant-dark.svg"
},
"result": {
"id": "1a2b3c4d-0000-0000-0000-000000000001",
"name": "Acme Holdings LLC",
"type": "Business",
"tin": "111111111",
"isTinCensored": false,
"amountDue": 18000,
"unallocatedCredits": 0,
"numMissingReturns": 1,
"balanceByYear": [
{
"year": 2023,
"principal": 14000,
"interest": 2600,
"penalties": 1400,
"allCredits": 0,
"unallocatedCredits": 0,
"amountDue": 18000
}
],
"lienSummary": {
"hasActiveLienSecuringNonZeroBalance": true,
"totalBalanceSecuredByLiens": 18000,
"mostRecentActiveLienFilingDate": "2024-05-14T00:00:00Z"
},
"installmentAgreementSummary": {
"hasBalanceNotCoveredByActiveIA": true,
"balanceNotCoveredByActiveIA": 18000,
"periodsNotCoveredByActiveIA": [
{
"formName": "1120",
"taxYear": 2023,
"taxPeriod": 0
}
]
},
"liens": [
{
"id": "3c4d5e6f-0000-0000-0000-000000000001",
"status": "Active",
"filingDate": "2024-05-14T00:00:00Z",
"currentSecuredBalance": 18000,
"securedPeriods": [
{
"formName": "1120",
"taxYear": 2023,
"taxPeriod": 0
}
],
"fullyRemovedDate": null,
"balanceAtRemoval": null
}
],
"installmentAgreements": []
}
}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
The access token obtained from the OAuth flow, sent as a Bearer credential.
Body
application/json
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.

