TIN Verification

Verify that a company’s legal name and Taxpayer Identification Number (EIN, or SSN for sole proprietors) match IRS records via IRS TIN matching.

Step 1: Create an applicant

Create an applicant to associate the verification with.

Curl
Python

export API_KEY=<YOUR_API_KEY>

curl -H "ds-api-token: $API_KEY" \
  -H "Content-Type: application/json" \
  -X POST "https://api.dataspike.io/api/v3/applicants" \
  --data '{"external_id": "company-456"}'

Response:

{
  "id": "01827ed4-c928-7a3c-9a30-7ab7cc169d11"
}

import requests

API_KEY = "<YOUR_API_KEY>"
BASE = "https://api.dataspike.io"
HEADERS = {"ds-api-token": API_KEY, "Content-Type": "application/json"}

resp = requests.post(f"{BASE}/api/v3/applicants", headers=HEADERS, json={"external_id": "company-456"})
applicant_id = resp.json()["id"]

Step 2: Submit TIN verification request

Provide the TIN and the legal business name. The TIN may contain dashes (they are ignored); it must contain 9 digits.

Curl
Python

APPLICANT_ID="01827ed4-c928-7a3c-9a30-7ab7cc169d11"

curl -H "ds-api-token: $API_KEY" \
  -H "Content-Type: application/json" \
  -X POST "https://api.dataspike.io/api/v4/kyb/$APPLICANT_ID/tin-verification" \
  --data '{
    "tin": "36-2382580",
    "company_name": "DEERE & COMPANY"
  }'

Response (HTTP 202):

{
  "request_id": "019c9e79-4d64-73e1-9f30-5374f0f57975",
  "status": "initial"
}

resp = requests.post(
    f"{BASE}/api/v4/kyb/{applicant_id}/tin-verification",
    headers=HEADERS,
    json={"tin": "36-2382580", "company_name": "DEERE & COMPANY"},
)
request_id = resp.json()["request_id"]

Request body

Field	Type	Required	Description
`tin`	string	Yes	Taxpayer Identification Number (EIN or SSN). Dashes are ignored; must contain 9 digits.
`company_name`	string	Yes	Legal business name to match against the TIN.

Step 3: Poll for the result

The check typically completes within a few seconds. Poll the result endpoint until the status changes from initial.

Curl
Python

REQUEST_ID="019c9e79-4d64-73e1-9f30-5374f0f57975"

curl -H "ds-api-token: $API_KEY" \
  "https://api.dataspike.io/api/v4/kyb/result/$REQUEST_ID"

Example response (verified):

{
  "request_id": "019c9e79-4d64-73e1-9f30-5374f0f57975",
  "status": "verified",
  "verification_type": "tin_verification",
  "response_data": {
    "result": {
      "name": "DEERE & COMPANY",
      "tin": "362382580",
      "status": "TIN Matched",
      "irs_code": 7,
      "irs_reason": "TIN and Name combination matches IRS EIN records"
    }
  },
  "created_at": "2026-02-27T09:41:15.822681Z",
  "completed_at": "2026-02-27T09:41:18.583502Z"
}

import time

while True:
    resp = requests.get(f"{BASE}/api/v4/kyb/result/{request_id}", headers=HEADERS)
    result = resp.json()
    if result["status"] != "initial":
        break
    time.sleep(2)

print(result)

Response data

The response_data.result object contains the full IRS TIN-matching outcome. Fields the IRS does not return are omitted. The complete schema is in the API reference.

Field	Description
`name`	Business name that was submitted
`tin`	TIN that was submitted (digits only)
`status`	Match outcome, e.g. `TIN Matched` or `Did Not Match`
`irs_code`	IRS TIN-matching code (`6` = SSN, `7` = EIN, `8` = both match; `3` = no match)
`irs_reason`	Human-readable explanation of the IRS code
`irs_service_status`	IRS service status, when provided
`last_irs_check_date`	Date of the last IRS check, when provided

Result statuses

Status	Meaning
`verified`	The name and TIN match IRS records
`not_verified`	The name and TIN do not match
`failed`	The TIN could not be verified (invalid TIN or an error occurred)

Getting started

Web SDK

KYC Mobile SDK

Deepfake Detection

Document Verification

KYB Verification

AML Screening

MCP Server

Webhooks

Step 1: Create an applicant

Step 2: Submit TIN verification request

Request body

Step 3: Poll for the result

Response data

Result statuses

​Step 1: Create an applicant

​Step 2: Submit TIN verification request

​Request body

​Step 3: Poll for the result

​Response data

​Result statuses

Step 1: Create an applicant

Step 2: Submit TIN verification request

Request body

Step 3: Poll for the result

Response data

Result statuses