---
title: "View merchants by ID"
method: GET
path: "/merchant/v3"
tags: ["Merchant Service", "User Management"]
---

# View merchants by ID

`GET /merchant/v3`

Returns an array with information for one or more merchant accounts associated with the API user. 

To view the complete list of merchant accounts assigned to the API user, do not include any merchant IDs in the request.

<!-- theme: warning -->
> ⚠️ Try It
> 
> To use the Try It feature for this endpoint, you must use the credentials for your [Sandbox API user](https://docs.nexiopay.com/docs/sandbox-environments).


<div style="display:none;">

## Request parameters
- merchantIds

## Response parameters
- merchantId
- name
- currencyId
- isPaymentConfigured
- isPaymentRecoveryConfigured
- processor
- processor.id
- kountMerc
- kount
- kount.id
- kount.merc
- kount.merchantId
- isApmConfigured
- hasAuthorizeNetApmCreds
- createdAt
- updatedAt

</div>

## Query parameters

- `merchantIds` string

## Response `200`

Success

- object[]
  - `merchantId` string — The Nexio merchant ID (MID).
  - `name` string — The merchant's name.
  - `currencyId` string — The [three-digit ISO numeric currency code](https://en.wikipedia.org/wiki/ISO_4217) for the settlement currency of the merchant account. For information about valid values, see the [currency table](https://docs.nexiopay.com/docs/constant-transaction-values#currency-id-currencyid) in Guides.
  - `isPaymentConfigured` boolean — Specifies whether the account has been enabled to use the [Nexio Payment Service](https://docs.nexiopay.com/reference/createonetimeusetoken). Will be `true` if the account has been configured to use the service.
  - `isPaymentRecoveryConfigured` boolean — Specifies whether payment recovery has been configured on the account. Will be `true` if it has been configured.
  - `processor` object — Processor-specific information, if applicable for the merchant account. **Details will vary by processor. Do NOT code to any information included in this object**.
    - `id` integer — The Nexio-specific unique identifier for processor information about the transaction.
  - `kountMerc` string — The Kount merchant ID. (Different than Nexio's merchant ID).
  - `kount` object — Fraud data and rules for Kount, if applicable for the merchant account.
    - `id` integer — The Kount ID.
    - `merc` string — The Kount merchant ID. (Different than Nexio's merchant ID). This is the same as the `kountMerc` parameter in the response.
    - `merchantId` string — The merchant ID (MID). This is the same as the main `merchantId` parameter in the response.
  - `isApmConfigured` boolean — Specifies whether an alternative payment method (APM) has been configured to use with the merchant account. Will be `true` if one or more APMs have been configured for the account.
  - `hasAuthorizeNetApmCreds` boolean — Specifies whether credentials have been included for [Authorize.net](https://docs.nexiopay.com/docs/authorizenet-integration-guide) with the merchant account. Will be `true` if Authorize.net credentials have been included.
  - `createdAt` string, date-time — The date and time the merchant's Nexio account was created, formatted as an [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) date, expressed in UTC.
  - `updatedAt` string, date-time — The date and time the merchant's Nexio account was last updated, formatted as an [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) date, expressed in UTC.

## Other responses

- `401` — Unauthorized. For help with this error and other error codes, see [Common errors](https://docs.nexiopay.com/docs/common-errors) in the Guides area.

---

[API](https://skmtc.dev/nexiopay/apis/payments-api-reference.md) · [All operations](https://skmtc.dev/nexiopay/apis/payments-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nexiopay/payments-api-reference/revisions/b414b73979e5/schema)