Skip to main content
GET
/
v1
/
transactions
List payout transactions
curl --request GET \
  --url https://api.meridian.example.com/v1/transactions \
  --header 'X-Meridian-Api-Key: <x-meridian-api-key>' \
  --header 'X-Meridian-Program-Id: <x-meridian-program-id>' \
  --header 'X-Meridian-Signature: <api-key>' \
  --header 'X-Meridian-Timestamp: <x-meridian-timestamp>'
{
  "transactions": [
    {
      "id": "txn_01JVY8Y4N9X2M6S5Q7T1",
      "messageId": "msg_01JVY8Y4N9X2M6S5Q7T1",
      "source": {
        "type": "external_submission",
        "externalSubmission": {
          "id": "sub_01JVY8Y4N9X2M6S5Q7T1",
          "displayName": "Customer message submission"
        }
      },
      "type": "transfer",
      "createdAt": "2026-04-07T20:11:42Z",
      "updatedAt": "2026-04-07T20:12:05Z",
      "status": "PENDING",
      "statusReason": null,
      "externalId": "e2e-20260407-000123",
      "relatedTransactionId": null,
      "amounts": {
        "debit": {
          "amount": "125000.00",
          "currency": "USD"
        },
        "credit": {
          "amount": "124975.00",
          "currency": "USD"
        },
        "fees": [
          {
            "type": "NETWORK_FEE",
            "label": "Network fee",
            "amount": "25.00",
            "currency": "USD"
          }
        ],
        "exchangeRate": "1.0000"
      },
      "debitInstrument": {
        "type": "ORIGINATOR",
        "originator": {
          "displayName": "Northwind Imports LLC",
          "accountNumber": "****9021"
        }
      },
      "creditInstrument": {
        "type": "BENEFICIARY_ACCOUNT",
        "beneficiaryAccount": {
          "id": "bfa_01JVY8Y4N9X2M6S5Q7T1",
          "displayName": "Contoso Treasury USD Account",
          "currency": "USD"
        }
      }
    },
    {
      "id": "txn_01JVY91MN2C4J7S6Q8U2",
      "messageId": "msg_01JVY91MN2C4J7S6Q8U2",
      "source": {
        "type": "system_initiation"
      },
      "type": "transfer",
      "createdAt": "2026-04-07T19:58:11Z",
      "updatedAt": "2026-04-07T20:01:14Z",
      "status": "COMPLETED",
      "statusReason": null,
      "externalId": "e2e-20260407-000122",
      "relatedTransactionId": "txn_01JVY8Y4N9X2M6S5Q7T1",
      "amounts": {
        "debit": {
          "amount": "124975.00",
          "currency": "USD"
        },
        "credit": {
          "amount": "124975.00",
          "currency": "USD"
        },
        "fees": [],
        "exchangeRate": "1.0000"
      },
      "debitInstrument": {
        "type": "BALANCE",
        "balance": {
          "id": "bal_01JVY91MN2C4J7S6Q8U2",
          "displayName": "USD settlement balance",
          "currency": "USD"
        }
      },
      "creditInstrument": {
        "type": "BENEFICIARY_ACCOUNT",
        "beneficiaryAccount": {
          "id": "bfa_01JVY91MN2C4J7S6Q8U2",
          "displayName": "Contoso Treasury USD Account",
          "currency": "USD"
        }
      }
    }
  ],
  "pageIndex": 1,
  "pageSize": 50,
  "totalRecords": 2
}

Authorizations

​
X-Meridian-Signature
string
header
required

Meridian HMAC header authentication.

Required headers:

  • X-Meridian-Api-Key
  • X-Meridian-Program-Id
  • X-Meridian-Timestamp
  • X-Meridian-Signature

Headers

​
X-Meridian-Program-Id
string
required

Identifies your Meridian program. Required on all requests but not included in the canonical signing string.

Required string length: 8 - 128
​
X-Meridian-Api-Key
string
required

Public client key identifier used to look up the HMAC secret

Required string length: 8 - 128
​
X-Meridian-Timestamp
string<date-time>
required

RFC 3339 UTC timestamp used in the HMAC signing string and replay protection. Requests outside the accepted clock skew window should be rejected.

​
X-Meridian-Signature
string
required

HMAC-SHA256 signature of the canonical signing string. Recommended format: sha256={hex_digest}

Pattern: ^sha256=[A-Fa-f0-9]{64}$

Query Parameters

​
pageIndex
integer
Required range: x >= 1
​
pageSize
integer
default:50
Required range: 1 <= x <= 200
​
messageId
string

Optional filter using the Meridian-assigned message identifier returned when the message was accepted

Required string length: 8 - 128

Response

Transactions listed successfully

​
transactions
object[]
required
​
pageIndex
integer
required
​
pageSize
integer
required
​
totalRecords
integer
required