---
title: "Get taxpayer details"
method: GET
path: "/api/demographics/v2/Taxpayers/{merchantNumber}"
tags: ["Tax Payer"]
---

# Get taxpayer details

`GET /api/demographics/v2/Taxpayers/{merchantNumber}`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/xplorpay/apis/external-us-onboarding-workflow/docs/api/demographics/v2/Taxpayers/:merchantNumber/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve taxpayer details for the merchant identified by merchantNumber.

## Path parameters

- `merchantNumber` string, required

## Query parameters

- `encryptedTin` boolean

## Response `200`

Returns a Taxpayer's details successfully.

- MerchantDemographicsApiModelsTaxpayerV2
  - `legalFirstName` string, nullable: First name of the tax payer.
  - `legalLastName` string, nullable: Last name of the tax payer.
  - `tin` string, required: Taxpayer Identification Number (TIN). Must be exactly 9 characters long.
  - `encryptedTIN` string, byte, nullable: Encrypted representation of the TIN for security purposes.
  - `tinLastFour` string, nullable: Represents last fout digits of TIN number
  - `tinTypeID` string, required: Identifier for the type of TIN. Must be between 1 and 3.
  - `businessLegalName` string, required: The legal name of the business associated with the taxpayer.
  - `stateIncorporatedCode` string, nullable: The state where the business is incorporated. Represented as a two-character code.

## Other responses

- `204`: No content.
- `400`: Bad Request: If merchant number is null or empty. Or URL refers to an obsolete version of API.
- `403`: Forbidden: The user does not have the necessary permissions to access this resource.
- `404`: Not Found: Taxpayer details not found.
- `500`: Internal Server Error: This could be due to system errors. Please contact support for assistance

---

[API](https://skmtc.dev/xplorpay/apis/external-us-onboarding-workflow.md) - [All operations](https://skmtc.dev/xplorpay/apis/external-us-onboarding-workflow/llms.txt) - [OpenAPI document](https://skmtc.dev/xplorpay/apis/external-us-onboarding-workflow/revisions/f37077c24b66?raw)