---
title: "Get a single merchant"
method: GET
path: "/v3/merchants/{mId}"
tags: ["MERCHANTS"]
---

# Get a single merchant

`GET /v3/merchants/{mId}`

## Path parameters

- `mId` string, required

## Query parameters

- `expand` string

## Headers

- `User-Agent` string, required

## Response `200`

Successful response. Merchant details are displayed.

- object
  - `id` string — Merchant unique identifier.
  - `name` string, required — Merchant name.
  - `reseller_id` string — Reseller identifier for the merchant.
  - `owner` object, required — Merchant's account owner.
    - `id` string — Employee unique identifier.
    - `name` string, required — Employee's full name.
    - `nickname` string — Employee's nickname (displayed on receipts).
    - `customId` string — Employee's custom identifier.
    - `email` string — Employee's email address. This field is optional.
    - `inviteSent` boolean — Indicates whether an invite was sent to the employee to activate their account. Values: True - Account activation invite sent to the employee. False - Account activation invite not sent to the employee.
    - `claimedTime` integer — Time when the employee claimed their account.
    - `deletedTime` integer — Time when the employee account was deleted.
    - `pin` string — Employee’s personal identification number (hashed PIN).
    - `unhashedPin` string — Employee’s personal identification number (unhashed PIN).
    - `role` 'OWNER' | 'ADMIN' | 'MANAGER' | 'EMPLOYEE' — Employee role. Values: Owner Admin Manager Employee
    - `roles` object[]
      - `id` string — Role unique identifier.
    - `isOwner` boolean — Indicates whether the employee has an Owner role for the merchant account. Values: True - Employee has an Owner role. False - Employee does not have an Owner role.
    - `shifts` object[] — Employee shift details.
      - `id` string — Unique identifier.
    - `payments` object[] — Payment transactions for the employee.
      - `id` string — Unique identifier.
    - `orders` object[] — Order details for the employee.
      - `id` string — Order unique identifier.
    - `employeeCards` object[] — Employee card details.
      - `id` string — Employee card unique identifier.
    - `merchant` object — Merchant who employs the employee
      - `id` string — Merchant unique identifier.
  - `address` object — Address of the merchant.
    - `address1` string — First line of the address. Can include the street address, PO box, or company name.
    - `address2` string — Second line of the address. Can include the apartment, suite, unit, or building number.
    - `address3` string — Third line of the address.
    - `city` string — City of the address.
    - `country` string — Country of the address.
    - `state` string — State of the address.
    - `zip` string — Postal code or ZIP of the address.

---

[API](https://skmtc.net/clover/apis/platform-api.md) · [All operations](https://skmtc.net/clover/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clover/platform-api/versions/08da265101a3/schema)