---
title: "Get business contact by Id"
method: GET
path: "/api/demographics/v1/BusinessContacts/{merchantNumber}/{businessContactId}"
tags: ["Business Contact"]
---

# Get business contact by Id

`GET /api/demographics/v1/BusinessContacts/{merchantNumber}/{businessContactId}`

## Request

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

Retrieve a specific business contact for the specified merchant using the businessContactId.

## Path parameters

- `merchantNumber` string, required
- `businessContactId` integer, required

## Query parameters

- `encryptedSsn` boolean

## Response `200`

Returns a single business contact successfully.

- MerchantDemographicsApiModelsBusinessContact
  - `phoneNumbers` MerchantDemographicsApiModelsBusinessContactPhone[], required: A collection of phone numbers.
    - `phoneTypeCodeID` string, required: Specifies the particular contact type.
    - `areaCode` string, required: The area code of the phone number, typically 3 digits.
    - `phoneNumber` string, tel, required: The phone number without the area code. Should be between 7 and 8 digits in length.
    - `extension` string, nullable: The phone number extension (optional).
  - `businessContactId` integer: Unique identifier for the business contact.
  - `contact` MerchantDemographicsApiModelsContact, required: Contains all details of the business contact.
    - `countryOfCitizenshipCode` string, required: The country code for the citizenship of the contact. Must be a valid ISO code between 1 and 840.
    - `address` MerchantDemographicsApiModelsContactAddress: Address details of the contact.
      - `line1` string, required: The first line of the address (Example, street address, P.O. box).
      - `line2` string, nullable: The second line of the address (optional).
      - `line3` string, nullable: The third line of the address (optional).
      - `city` string, required: The city or locality of the address.
      - `countryCode` string, required: The country code for the address. Typically a numeric code for the country.
      - `stateCode` string, required: The state or region code. Typically a 2-letter code representing the state.
      - `zip` string, required: The postal code (zip code) of the address.
    - `ssnLastFour` string, nullable: The last four digits of the contact's SSN (Social Security Number). Excluded from Swagger documentation.
    - `encryptedSSN` string, byte, nullable: The encrypted Social Security Number (SSN) of the contact.
    - `ssn` string, nullable: The full legal ID, such as SSN, of the contact. Strips dashes automatically.
    - `contactId` integer: The unique identifier for the contact. Excluded from Swagger documentation.
    - `firstName` string, required: The first name of the contact.
    - `lastName` string, required: The last name of the contact.
    - `dateOfBirth` string, nullable: The date of birth of the contact.
    - `dateOfBirthString` string, nullable: The date of birth in "MMddyyyy" format
  - `ownershipAmount` string, nullable: Ownership percentage or amount associated with the contact.
  - `emailAddress` string, required: The email address of the business contact.
  - `title` string, nullable: Job title or position of the business contact.
  - `contactTypes` MerchantDemographicsApiModelsBusinessContactContactType[], required: List of contact types associated with the business contact.
    - `businessContactContactTypeID` integer: The unique identifier for the BusinessContactContactType entity.
    - `businessContactID` integer: The unique identifier for the associated business contact.
    - `contactTypeID` integer: The unique identifier for the contact type associated with the business contact.
  - `isCompassUser` boolean: Indicates whether the contact is a Compass user.
  - `isMerchantHomeUser` boolean: Indicates whether the contact is a Merchant Home user.
  - `isVirtualTerminalUser` boolean: Indicates whether the contact is a Virtual Terminal user.
  - `isAuthorizedToPurchase` boolean: Specifies if the contact is authorized to make purchases.

## Other responses

- `400`: Bad Request: If merchant number is null or empty.
- `401`: Unauthorized: User does not have the required role or access.
- `403`: Forbidden: The user does not have the necessary permissions to access this resource.
- `404`: Not Found: BusinessContacts 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)