List Merchants — GET /merchants

The List Merchants endpoint returns all merchants associated with your credentials along with their current balances. Use this endpoint to display an overview of all your merchant accounts or to check balance positions across payment methods. GET /merchants

Authentication

Accepts a Bearer token (Authorization: Bearer <token>) or an API key (X-Api-Key: <key>).

Response fields

The endpoint returns an array of merchant objects.

string

required

The merchant’s unique identifier (UUID).

string

required

The merchant’s display name.

object[]

required

A list of balance entries, one per payment method.

Show properties

integer

required

The identifier for the payment method (cryptocurrency).

string

required

The available balance as a decimal string (e.g., "1.50000000").

string

required

The token symbol (e.g., "USDT", "ETH").

Example request

curl --request GET \
  --url https://api.iterapay.com/merchants \
  --header 'Authorization: Bearer <token>'

Example response

[
  {
    "id": "b0fcc813-a7ce-4bbc-932f-dbef6f59ca7f",
    "name": "My Store",
    "balances": [
      {
        "paymentMethodID": 1,
        "balance": "250.00000000",
        "symbol": "USDT"
      },
      {
        "paymentMethodID": 2,
        "balance": "0.04150000",
        "symbol": "ETH"
      }
    ]
  },
  {
    "id": "e2d1a4f6-88bc-4a91-b3e7-1c9f20d84b52",
    "name": "Second Store",
    "balances": [
      {
        "paymentMethodID": 1,
        "balance": "0.00000000",
        "symbol": "USDT"
      }
    ]
  }
]

Error responses

Status	Description
`401`	Missing or invalid credentials.
`403`	Valid credentials but insufficient permissions.

Overview

Merchants

Invoices

Transactions & Withdrawals

Settings

List Merchants — GET /merchants

Authentication

Response fields

Example request

Example response

Error responses

​Authentication

​Response fields

​Example request

​Example response

​Error responses

Authentication

Response fields

Example request

Example response

Error responses