---
title: "Get a merchant"
method: GET
path: "/merchants/{merchant_id}"
tags: ["Merchants"]
---

# Get a merchant

`GET /merchants/{merchant_id}`

Retrieve detailed information about a specific merchant by referring to its unique identifier (ID). The API documentation provides instructions on how to make a request using the merchant ID as a parameter, allowing you to fetch the specific merchant's details, including its attributes, status and any other relevant information available in the system.

## Query parameters

- `with` 'merchant_currencies' | 'merchant_payment_methods' | 'merchant_card_types' | 'primary_merchant_category' | 'secondary_merchant_category'

## Response `200`

OK

- object
  - `merchant_id` integer
  - `merchant_name` string
  - `gateway_id` integer
  - `currency_id` integer — Default currency
  - `merchant_mid_id` string
  - `merchant_descriptor` string
  - `merchant_phone` string
  - `merchant_url` string
  - `merchant_active` boolean
  - `merchant_processor` string, nullable
  - `merchant_mcc_code` string, nullable
  - `merchant_processing_limit` string
  - `merchant_processing_inforce` boolean
  - `merchant_daily_rebills_limit` string
  - `merchant_state` string, nullable
  - `merchant_tax` string
  - `merchant_mtd_revenue` string
  - `merchant_mtd_transactions` integer
  - `merchant_mtd_initial` integer
  - `merchant_processing_perc` string
  - `primary_merchant_category_id` integer
  - `secondary_merchant_category_id` integer
  - `merchant_notes` string, nullable
  - `date_created` string, date-time
  - `created_by` integer
  - `date_modified` string, date-time
  - `modified_by` integer
  - `merchant_currencies` object[]
    - `currency_id` integer
    - `currency_value` string
  - `merchant_payment_methods` object[]
    - `payment_method_id` integer
    - `payment_method_name` string
  - `merchant_card_types` object[]
    - `card_type_id` integer
    - `card_type_name` string
  - `primary_merchant_category` object, nullable
    - `merchant_category_id` integer
    - `merchant_category_name` string
  - `secondary_merchant_category` object, nullable
    - `merchant_category_id` integer
    - `merchant_category_name` string

## Other responses

- `401` — Unauthorized response
- `403` — Forbidden response
- `404` — Not Found response
- `500` — Error response

---

[API](https://skmtc.net/vrio/apis/crm-configuration.md) · [All operations](https://skmtc.net/vrio/apis/crm-configuration/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vrio/crm-configuration/revisions/62037010356e/schema)