---
title: "Get Merchant Processors and Value Added Services Details"
method: POST
path: "/v4/processors/reports"
tags: ["Processors and Services"]
---

# Get Merchant Processors and Value Added Services Details

`POST /v4/processors/reports`

> ❗️ Never Use Real API Keys
>
> Never use real API Keys when testing. The gateway allows Partners to create Test Merchant Accounts. Testing should always use keys from the Test Accounts and never keys from a Standard Account.
<details>
<summary>Usage</summary>
This request will return all services that are active, offered, or in a free trial state for a merchant, or a list of merchants. This will return every detail you can see in the partner portal, so the responses can be quite lengthy if the merchant has several processors and numerous services available to them.
</details>

## Headers

- `Content-Type` string, required
- `Authorization` string, required

## Request body

- GetMerchantProcessorsAndValueAddedServicesDetailsRequest
  - `maxResults` string, required — Number of max results in response. Must be in range from 1 to 1000.
  - `merchantIds` string[] — Array of merchant IDs.
  - `offset` string — Start point for the responses

## Response `200`

Success

- GetMerchantProcessorsAndValueAddedServicesDetailsResponse
  - `objectType` 'report' — The type of object that was returned as a result of the request.
  - `reportId` integer — The report's ID.
  - `offset` integer — The offset for paginated results.
  - `maxResults` integer — The maximum number of results.
  - `totalResults` integer — The total number of results.
  - `hasMore` boolean — Indicates if there are more results to be fetched.
  - `links` object — Links for navigating the paginated results.
    - `first` string — Link to the first page of results.
    - `last` string — Link to the last page of results.
    - `next` string — Link to the next page of results.
    - `previous` string — Link to the previous page of results.
  - `results` object[] — Array of processor objects.
    - `objectType` string — The type of object that was returned as a result of the request.
    - `id` integer — The unique identifier of the processor or service instance added.
    - `processorType` string — The type of the processor added.
    - `processorId` string — The ID of the processor added.
    - `processorName` string — The name of the processor added.
    - `serviceId` string — The code name of the processor platform or service added.
    - `merchantId` string — The merchant's Gateway ID.
    - `mcc` string — The Merchant Category Code.
    - `accountClassification` string — The account classification of the processor added.
    - `maxTicketAmount` string — The maximum amount for a single transaction run through the added processor.
    - `maxMonthlyVolume` string — The maximum total amount that can be run through the processor in a single month.
    - `applyToAllCardType` boolean — Whether the maxMonthlyVolume and maxTicketAmount apply to all payment methods through the added processor or not.
    - `enableDuplicateChecking` boolean — Whether duplicate checking is enabled or not.
    - `allowMerchantOverride` boolean — Whether the merchant is allowed to ignore the duplicate check on a per-transaction basis or not.
    - `freeTrialEndDate` string — End date of free trial.
    - `freeTrialDaysLeft` string — Days left of free trial.
    - `duplicateTime` string — The amount of time in seconds to look back to check if a transaction is a duplicate.
    - `status` 'active' | 'pending' — The status of the added processor or service, depending on the processor/billing authorization status.
    - `condition` 'offered' | 'notOffered' | 'mandatory' — The condition of the added processor or service.
    - `extraDetails` object — Any extra details about the added processor.
    - `created` string — The date and time of when the processor or service was added.
    - `updated` string — The date and time of when the processor or service was last updated.
    - `supportsReroutedRefunds` boolean — Whether the added processor supports rerouted refunds or not.
    - `shouldDisableFields` boolean — Whether the added processor should disable fields or not.
    - `disabled` boolean — Whether the processor is disabled or not.
    - `refundProcessor` string — The specified processor to reroute future refunds to, if this processor is disabled.
    - `billingType` string — The billing type of the added processor or service.
    - `avsCvvPreCheck` string — The AVS/CVV precheck method for the added processor.
    - `skipAvsCvv` boolean — Whether skipping AVS/CVV is enabled for the added processor or not.
    - `processorFields` object — The processor-dependent fields for the added processor.
    - `paymentTypes` string[] — The allowed payment types for the added processor.
    - `descriptor` object — The descriptor fields for the added processor.
      - `descriptor` string — The descriptor for the added processor.
      - `phone` string — The descriptor phone number for the added processor.
      - `city` string — The descriptor city for the added processor.
      - `state` string — The descriptor state for the added processor.
      - `url` string — The descriptor URL for the added processor.
    - `currencies` string[] — The allowed currencies for the added processor.
    - `requiredFields` object — The fields that are required to be populated for each transaction.
      - `name` boolean — Whether the name is a required field or not.
      - `company` boolean — Whether the company is a required field or not.
      - `address` boolean — Whether the address is a required field or not.
      - `city` boolean — Whether the city is required field or not.
      - `state` boolean — Whether the state is a required field or not.
      - `zip` boolean — Whether the ZIP code is a required field or not.
      - `country` boolean — Whether the country is a required field or not.
      - `phone` boolean — Whether the phone is a required field or not.
      - `email` boolean — Whether the email is a required field or not.
      - `driversLicense` boolean — Whether the driver's license is a required field or not.
      - `driversLicenseState` boolean — Whether the driver's license state is a required field or not.
      - `driversLicenseDob` boolean — Whether the driver's license date of birth is a required field or not.
      - `ssn` boolean — Whether the SSN is a required field or not.
      - `cvv` string — The CVV requirement setting.
      - `fax` boolean — Whether the fax is a required field or not.
      - `url` boolean — Whether the URL is a required field or not.
      - `orderId` boolean — Whether the order ID is a required field or not.
      - `orderDescription` boolean — Whether the order description is a required field or not.
      - `poNumber` boolean — Whether the PO number is a required field or not.
      - `shipping` boolean — Whether shipping is a required field or not.
      - `tax` boolean — Whether tax is a required field or not.
      - `shippingName` boolean — Whether the shipping name is a required field or not.
      - `shippingAddress` boolean — Whether the shipping address is a required field or not.
      - `shippingCity` boolean — Whether the shipping city is a required field or not.
      - `shippingState` boolean — Whether the shipping state is a required field or not.
      - `shippingZip` boolean — Whether the shipping ZIP code is a required field or not.
      - `shippingCountry` boolean — Whether the shipping country is a required field or not.
      - `mdf1` boolean — Whether Merchant Defined Field 1 is a required field or not.
      - `mdf2` boolean — Whether Merchant Defined Field 2 is a required field or not.
      - `mdf3` boolean — Whether Merchant Defined Field 3 is a required field or not.
      - `mdf4` boolean — Whether Merchant Defined Field 4 is a required field or not.
      - `mdf5` boolean — Whether Merchant Defined Field 5 is a required field or not.
      - `mdf6` boolean — Whether Merchant Defined Field 6 is a required field or not.
      - `mdf7` boolean — Whether Merchant Defined Field 7 is a required field or not.
      - `mdf8` boolean — Whether Merchant Defined Field 8 is a required field or not.
      - `mdf9` boolean — Whether Merchant Defined Field 9 is a required field or not.
      - `mdf10` boolean — Whether Merchant Defined Field 10 is a required field or not.
      - `mdf11` boolean — Whether Merchant Defined Field 11 is a required field or not.
      - `mdf12` boolean — Whether Merchant Defined Field 12 is a required field or not.
      - `mdf13` boolean — Whether Merchant Defined Field 13 is a required field or not.
      - `mdf14` boolean — Whether Merchant Defined Field 14 is a required field or not.
      - `mdf15` boolean — Whether Merchant Defined Field 15 is a required field or not.
      - `mdf16` boolean — Whether Merchant Defined Field 16 is a required field or not.
      - `mdf17` boolean — Whether Merchant Defined Field 17 is a required field or not.
      - `mdf18` boolean — Whether Merchant Defined Field 18 is a required field or not.
      - `mdf19` boolean — Whether Merchant Defined Field 19 is a required field or not.
      - `mdf20` boolean — Whether Merchant Defined Field 20 is a required field or not.
    - `faceConfiguration` object — The FACe configuration for the added processor.
    - `disabledFields` object — The disabled fields for the added processor.
      - `processorFields` object — The processor-dependent fields and whether they are disabled or not.
    - `settlementTime` string — The time settlement occurs.
    - `settlementTimezone` string — The timezone of the configured settlement time.

---

[API](https://skmtc.net/nmi/apis/embedded-components-api.md) · [All operations](https://skmtc.net/nmi/apis/embedded-components-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nmi/embedded-components-api/versions/45c2ecda3685/schema)
