---
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}`

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.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)