Sign in

v1

latestOpenAPI 3.0.12026-07-2356172250.9 KB
Tax Payer

Get taxpayer details

Retrieve taxpayer details for the merchant identified by merchantNumber.

get/api/demographics/v2/Taxpayers/{merchantNumber}

Path parameters

merchantNumberstring required

The merchant's unique identification number.

Query parameters

encryptedTinboolean

Specifies whether to return the Taxpayer Identification Number (TIN) in encrypted format.

Response

Returns a Taxpayer's details successfully.

legalFirstNamestring nullable

First name of the tax payer.

legalLastNamestring nullable

Last name of the tax payer.

tinstring required

Taxpayer Identification Number (TIN). Must be exactly 9 characters long.

encryptedTINstring byte nullable

Encrypted representation of the TIN for security purposes.

tinLastFourstring nullable

Represents last fout digits of TIN number

tinTypeIDstring required

Identifier for the type of TIN. Must be between 1 and 3.

businessLegalNamestring required

The legal name of the business associated with the taxpayer.

stateIncorporatedCodestring nullable

The state where the business is incorporated. Represented as a two-character code.