---
title: "See Merchants' Billing"
method: POST
path: "/v4/billing/reports"
tags: ["Gateway Features", "Billing & Commission"]
---

# See Merchants' Billing

`POST /v4/billing/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 will let you see what billing has occurred on merchants under your partner account. Billing reports are for Bill to Affiliate partners only. For Bill to Merchant partners, you will likely want commission and bill to me reports. 
</details>

## Headers

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

## Request body

- SeeMerchantBillingRequest
  - `maxResults` string, required — Required. Value must be between 1-1000.
  - `startDate` string, required — Required. Start point for the responses.
  - `endDate` string, required — Required. End point for the responses.
  - `offset` string, required — Required. "offset": 0 // Like all reports and search endpoints, you can specify the offset, which is the start point for the responses

## Response `200`

Success

- SeeMerchantBillingResponse
  - `objectType` 'serviceConfig' — The type of object that was returned as a result of the request.
  - `reportId` number — The ID of the report.
  - `offset` number — The first N skipped results.
  - `maxResults` number — The max number results.
  - `totalResults` number — The total number of results.
  - `hasMore` boolean — If are there more results for the search.
  - `links` object[] — Links for querying results.
    - `first` string — First page of query results.
    - `last` string — Last page of query results.
    - `next` string — Next page of current query results.
    - `previous` string — Previous page of current query results.
  - `results` object[] — Results for the search.
    - `objectType` string — Type of the returned response object
    - `rowId` string — The ID for the row.
    - `merchantId` string — The merchant's Gateway ID.
    - `affiliateId` string — Affiliate ID. To get user information for a sub-affiliate account, pass in `affiliateId` instead of `merchantId`.
    - `quantity` string — Quantity
    - `serviceId` string — The ID of the service.
    - `processorId` string — The ID of the payment processor.
    - `fee` object — Response variables specifically related to fees.
      - `feeType` string — The type of the fee.
      - `name` string — The name of the fee.
      - `description` string — The description of the fee.
      - `serviceId` string — The ID of the fee service.
    - `cost` object — Response variables specifically related to cost.
      - `objectType` string — The type of cost object that was returned as a result of the request.
      - `amount` string — The amount of the cost object.
      - `currency` string — The currency of the cost object.
    - `total` object — Response variables specifically related to total.
      - `objectType` string — The type of total object that was returned as a result of the request.
      - `amount` string — The amoount of the total object.
      - `currrency` string — The currency of the total object.

---

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