United States

United States eKYB validates the legitimacy of US businesses by checking their tax ID, business name, address, and UBOs against US government sources of truth.

US eKYB is offered in two variants:

Advanced: Core verification including business name, tax ID, address, city, postal code, registration status, and UBO name match.
Advanced+: Everything in Advanced, plus address deliverability, address property type, entity type, and the full list of individuals associated with the business.

Both variants use the same endpoint, request parameters, and match fields. Advanced+ returns additional response fields not present in Advanced.

Sources

Country	Source	Description
United States	Advanced	Verifies business details against IRS records and state Secretary of State filings.
United States	Advanced+	Same source as Advanced, plus additional verification including USPS address deliverability and full people lookup.

Direct API approach

For general integration notes and shared response semantics, see the eKYB API Reference.

Request parameters

Request parameters are identical for Advanced and Advanced+.

Parameter	Required	Description
`plugins`	Mandatory	Array. Must be `["ekyb"]`.
`businessName`	Mandatory	String. Name of the business.
`country`	Mandatory	String. Two-letter Alpha-2 country code. Must be `US`.
`taxId`	Mandatory	String. Accepts a 9-digit EIN issued by the IRS or a state-issued business registration number. See Tax ID formats for details.
`street`	Optional	String. Street name of the business.
`houseNo`	Optional	String. Building or house number.
`addressLine2`	Optional	String. Second line of the business address (for example, apartment or unit number).
`city`	Optional	String. City in the business address.
`state`	Optional	String. State in the business address.
`postalCode`	Optional	String. 5-digit US postal code.
`uboNames`	Optional	Array. Full legal names of Unique Beneficial Owners to check against records associated with the business.

At least one field from street, houseNo, addressLine2, city, state, or postalCode must be provided.

Tax ID formats

Tax ID Type	Format
EIN	9 digits, issued by the IRS.
State Registration Number	No standard format; varies by state.

Sample request

{
  "plugins": ["ekyb"],
  "businessName": "Delta International Inc.",
  "street": "SW 72nd Ave",
  "houseNo": "4856",
  "city": "MIAMI",
  "state": "FL",
  "postalCode": "33155",
  "country": "US",
  "taxId": "XXXXXXXXX",
  "uboNames": ["Jose A Santos"]
}

Sample response — Advanced

{
  "kyb": [
    { "key": "name", "status": "success", "sub_label": "Verified", "message": "Match identified to the submitted Business Name" },
    { "key": "tin", "status": "success", "sub_label": "Verified", "message": "The IRS has a record for the submitted TIN and Business Name combination" },
    { "key": "address_verification", "status": "success", "sub_label": "Verified", "message": "Match identified to the submitted Office Address" },
    { "key": "registrationStatus", "sub_label": "Active" },
    { "key": "postalCodeMatch", "sub_label": "Verified" },
    { "key": "cityMatch", "sub_label": "Verified" },
    { "key": "ubo_name_match", "status": "success", "sub_label": "Verified" }
  ]
}

Sample response — Advanced+

{
  "kyb": [
    { "key": "name", "status": "success", "sub_label": "Verified", "message": "Match identified to the submitted Business Name" },
    { "key": "tin", "status": "success", "sub_label": "Verified", "message": "The IRS has a record for the submitted TIN and Business Name combination" },
    { "key": "address_verification", "status": "success", "sub_label": "Verified", "message": "Match identified to the submitted Office Address" },
    { "key": "address_deliverability", "status": "success", "sub_label": "Deliverable", "message": "The USPS is able to deliver mail to the submitted Office Address" },
    { "key": "address_property_type", "status": "success", "sub_label": "Commercial", "message": "Submitted Office Address is a Commercial property" },
    { "key": "postalCodeMatch", "sub_label": "Verified" },
    { "key": "cityMatch", "sub_label": "Verified" },
    { "key": "registrationStatus", "sub_label": "Active" },
    {
      "key": "entityType",
      "entityType": { "entityType": "Private limited with Share Capital" }
    },
    { "key": "ubo_name_match", "status": "success", "sub_label": "Verified" },
    {
      "key": "people",
      "people": [
        { "name": "PANDO, ADA B.", "titles": [{ "title": "DIRECTOR" }] },
        { "name": "PANDO, SARAH A.", "titles": [{ "title": "DIRECTOR" }] },
        {
          "name": "MARTIN, JOHN",
          "titles": [
            { "title": "DIRECTOR" },
            { "title": "REGISTERED AGENT" }
          ]
        },
        {
          "name": "SANTOS, JOSE A",
          "titles": [
            { "title": "CEO" },
            { "title": "PRESIDENT" },
            { "title": "REGISTERED AGENT" },
            { "title": "VICE PRESIDENT" }
          ]
        }
      ]
    }
  ]
}

Response fields

The Available column indicates which variants return each field.

Key	Available	Status	Description
`name`	Advanced, Advanced+	`Verified`, `Approximate Match`, `Unverified`	Submitted business name against the business name associated with the tax ID.
`tin`	Advanced, Advanced+	`Verified`, `Unverified`	Submitted tax ID against the government database. See Tax ID verification messages for the specific messages returned per Tax ID type and outcome.
`address_verification`	Advanced, Advanced+	`Verified`, `Approximate Match`, `Unverified`	Submitted address against the address associated with the tax ID.
`address_deliverability`	Advanced+	`Deliverable`, `Not Deliverable`	USPS deliverability status of the submitted address.
`address_property_type`	Advanced+	`Commercial`, `Residential`	Property type of the submitted address.
`cityMatch`	Advanced, Advanced+	`Verified`, `Approximate Match`, `Unverified`	Submitted city against the city associated with the tax ID.
`postalCodeMatch`	Advanced, Advanced+	`Verified`, `Unverified`	Submitted postal code against the postal code associated with the tax ID.
`registrationStatus`	Advanced, Advanced+	`Active`, `Inactive`, `Unknown`	Registration status of the business across states with SOS filings. `Active` if active in some or all states; `Inactive` if suspended or inactive in all; `Unknown` if not available.
`entityType`	Advanced+	Legal entity type of the business	The legal entity type of the company, if available. If not available, displays `Unknown`.
`ubo_name_match`	Advanced, Advanced+	`Verified`, `Approximate Match`, `Unverified`	Submitted UBO against UBOs associated with the business. Distinguished by the `uboName_input` field on each entry.
`people`	Advanced+	Array of individuals and their titles	Full list of individuals associated with the business entity, with associated titles (for example, DIRECTOR, REGISTERED AGENT, CEO, PRESIDENT, VICE PRESIDENT).

The sub_label field is the primary indicator of match outcome. Response entries that also include status and message fields provide additional context useful for risk-based decisioning.

Tax ID verification messages

The tin response field returns a message describing the specific verification outcome. Messages differ based on Tax ID type and match outcome.

Tax ID Type	Condition	Message
EIN	Tax ID is found in IRS and valid	The IRS has a record for the submitted TIN and Business Name combination.
EIN	Tax ID is found in IRS but not associated with the submitted Business Name	We believe the submitted TIN is associated with a different business name.
EIN	Tax ID is not found in IRS	The IRS does not have a record for the submitted TIN and Business Name combination.
State-issued Tax ID	Tax ID and Business Name are associated with each other	The Tax ID provided is associated with the Business Name.
State-issued Tax ID	Tax ID and Business Name are not associated with each other	We could not determine a record for the submitted TIN and Business Name combination.
State-issued Tax ID	Neither Tax ID nor Business Name could be found	We could not find a business with the provided name or tax ID.

Error responses

See the eKYB API Reference for standard error responses.

Single Session Dashboard results

View eKYB results on the Business tab in single Session view.