List Merchants
curl --request GET \
--url https://api.example.com/api/v1/management/merchants \
--header 'x-api-key: <x-api-key>'import requests
url = "https://api.example.com/api/v1/management/merchants"
headers = {"x-api-key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};
fetch('https://api.example.com/api/v1/management/merchants', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/api/v1/management/merchants",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <x-api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v1/management/merchants"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<x-api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/api/v1/management/merchants")
.header("x-api-key", "<x-api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/management/merchants")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<x-api-key>'
response = http.request(request)
puts response.read_body{
"merchants": [
{
"id": "<string>",
"name": "<string>",
"email": "<string>",
"wallet_address": "<string>",
"balance": "<string>",
"created_at": "<string>"
}
]
}Merchants
List Merchants
Retrieve a list of all merchants associated with your company and their current balances.
GET
/
api
/
v1
/
management
/
merchants
List Merchants
curl --request GET \
--url https://api.example.com/api/v1/management/merchants \
--header 'x-api-key: <x-api-key>'import requests
url = "https://api.example.com/api/v1/management/merchants"
headers = {"x-api-key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};
fetch('https://api.example.com/api/v1/management/merchants', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/api/v1/management/merchants",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <x-api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v1/management/merchants"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<x-api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/api/v1/management/merchants")
.header("x-api-key", "<x-api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/management/merchants")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<x-api-key>'
response = http.request(request)
puts response.read_body{
"merchants": [
{
"id": "<string>",
"name": "<string>",
"email": "<string>",
"wallet_address": "<string>",
"balance": "<string>",
"created_at": "<string>"
}
]
}Headers
string
required
Your test or live SDK Secret Key (
sk_test_... or sk_live_...).Response Fields
array
Show Merchant Item
Show Merchant Item
string
Unique identifier for the merchant (e.g.,
mch_abc123).string
The merchant’s legal or display name.
string
The merchant’s contact email.
string
The USDC wallet address provisioned for this merchant on Base.
string
Current USDC balance of the merchant’s wallet.
string
ISO 8601 timestamp of when the merchant account was created.
Response Example
{
"merchants": [
{
"id": "mch_abc123",
"name": "Coffee Haven",
"email": "owner@coffeehaven.com",
"wallet_address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
"balance": "150.50",
"created_at": "2026-03-28T22:33:53Z"
},
{
"id": "mch_def456",
"name": "The Juice Bar",
"email": "billing@juicebar.io",
"wallet_address": "0x1234567890abcdef1234567890abcdef12345678",
"balance": "85.20",
"created_at": "2026-03-29T10:15:00Z"
}
]
}
⌘I

