EIN verification

​

Verify a business EIN against IRS records.

Send a JSON body. Call in one of two ways:

  1. By application — provide app_id. business_name and ein are read from the application data on file.
  2. Directly — provide business_name and ein without an app_id.

If app_id is provided together with business_name and ein, the supplied values are used as-is. EINs are normalized to 9 digits; placeholders such as 000000000 are rejected.

Body·EinVerificationRequest

required
application/json
  • app_id
    Type: string

    Existing Kaaj application ID. Required if business_name and ein are not both provided.

  • business_name
    Type: string

    Legal name of the business. Required if app_id is not provided.

  • ein
    Type: string

    9-digit EIN. Dashes are allowed and stripped. Required if app_id is not provided.

Responses

  • application/json
  • application/json
  • 401

    Missing or invalid Bearer token. Response body is empty.

  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/application/ein-verification
curl https://api.kaaj.ai/application/ein-verification \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "app_id": "Kaaj-app-1"
}'
Cached result for an existing application
{
  "from_db": true,
  "ein_verification": {
    "app_id": "Kaaj-app-1",
    "business_name": "Kaaj-business-1",
    "ein": "123456789",
    "ein_matched": true,
    "is_valid_ein": true,
    "is_valid_tin": true,
    "match_status": "EIN Possible Match found.",
    "validation_status": "IRS Match found. TIN and Name combination matches IRS EIN records",
    "possible_match": "KAAJ-BUSINESS-1"
  }
}

EIN verification result