Skip to main content
GET
/
v1
/
accounts
List Accounts
curl --request GET \
  --url https://sandbox-api.va.meridianpay.com/v1/accounts
{
  "data": [
    {
      "id": "acc_01JMERUSDRET001",
      "createdAt": "2026-04-30T14:00:00Z",
      "updatedAt": "2026-04-30T14:00:00Z",
      "status": "ACTIVE",
      "statusReason": null,
      "currency": "USD",
      "depositReconciliationId": "prop-ct-oak-7421",
      "displayName": null
    }
  ],
  "pageIndex": 0,
  "pageSize": 25,
  "totalRecords": 1
}

Headers

​
Authorization
string

Bearer authentication header of the form Bearer {token}. Required for client-server (JWT) authentication. See Authentication.

​
X-Meridian-Program-Id
string

Identifies the program context for the request. Required for server-to-server (HMAC) authentication. See Authentication.

​
X-Meridian-User-Id
string

Identifies the Meridian user targeted by the request. Required for server-to-server (HMAC) authentication with MULTI_USER integrations; omit for SINGLE_USER. See Authentication.

​
X-Meridian-Api-Key
string

Partner API key issued by Meridian during provisioning. Required for server-to-server (HMAC) authentication. See Authentication.

​
X-Meridian-Timestamp
string

Current time in milliseconds since the Unix epoch. Must be within 60 seconds of the request. Required for server-to-server (HMAC) authentication. See Authentication.

​
X-Meridian-Signature
string

HMAC SHA-256 signature of the canonical request string, computed per request. Required for server-to-server (HMAC) authentication. See Authentication for how to construct it.

Response

The accounts for the authenticated account

Accounts associated with the authenticated Meridian account

​
data
Account Response · object[]
required

List of accounts

​
pageIndex
integer
required

Current page index

Example:

0

​
pageSize
integer
required

Number of records per page

Example:

25

​
totalRecords
integer
required

Total number of records

Example:

3