Skip to main content
POST
Send a TIN along with either a businessName or a firstName and lastName. The result indicates whether the SSN/EIN matches the entity name according to the IRS, and if not, whether the TIN has been issued. See TIN verification results for every response.

Authorizations

​
Authorization
string
header
required

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

Body

application/json

A TIN plus exactly one name shape: businessName, or firstName and lastName, never both. SSNs and EINs both verify.

​
tin
string
required

Both shapes: the TIN to verify: nine digits, with dashes and spaces ignored.

Example:

"11-1111111"

​
businessName
string

Business shape: the business name to verify against.

​
firstName
string

Individual shape: the individual's first name.

​
lastName
string

Individual shape: the individual's last name.

Response

Verification completed. result carries the definitive answer; verifiedAtUtc is when it was produced.

​
result
enum<string>
required

The definitive verification result. See the TIN verification results page for the full meaning of each value.

Available options:
Matched,
Mismatched,
NotIssued
​
verifiedAtUtc
string<date-time>
required

When the answer was produced.