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

# Get taxpayer details

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

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.net/xplorpay/apis/external-us-onboarding-workflow.md) · [All operations](https://skmtc.net/xplorpay/apis/external-us-onboarding-workflow/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xplorpay/external-us-onboarding-workflow/revisions/f37077c24b66/schema)