Search transactions

curl --request GET \
  --url https://api-sb.meld.io/payments/transactions \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api-sb.meld.io/payments/transactions', 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-sb.meld.io/payments/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <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-sb.meld.io/payments/transactions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api-sb.meld.io/payments/transactions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "count": 123,
  "remaining": 123,
  "totalCount": 123,
  "transactions": [
    {
      "createdAt": "2023-11-07T05:31:56Z",
      "id": "<string>",
      "serviceProvider": "<string>",
      "sessionId": "<string>",
      "status": "<string>",
      "transactionType": "<string>",
      "updatedAt": "2023-11-07T05:31:56Z",
      "accountId": "<string>",
      "apiAccessProfileId": "<string>",
      "countryCode": "<string>",
      "cryptoDetails": {
        "blockchainTransactionId": "<string>",
        "chainId": "<string>",
        "institution": "<string>",
        "networkFee": 123,
        "networkFeeInUsd": 123,
        "offrampDestinationWalletAddress": "<string>",
        "partnerFee": 123,
        "partnerFeeInUsd": 123,
        "swapFee": 123,
        "swapFeeInUsd": 123,
        "totalFee": 123,
        "totalFeeInUsd": 123,
        "transactionFee": 123,
        "transactionFeeInUsd": 123,
        "walletAddress": "<string>"
      },
      "customer": {
        "accountId": "<string>",
        "addresses": [
          {
            "addressDetails": {
              "city": "<string>",
              "country": "<string>",
              "firstName": "<string>",
              "lastName": "<string>",
              "lineOne": "<string>",
              "lineTwo": "<string>",
              "postalCode": "<string>",
              "region": "<string>"
            },
            "type": "BILLING"
          }
        ],
        "email": "<string>",
        "externalId": "<string>",
        "id": "<string>",
        "name": {
          "firstName": "<string>",
          "lastName": "<string>"
        },
        "phone": "<string>",
        "serviceProviders": {},
        "status": "<string>"
      },
      "description": "<string>",
      "destinationAmount": 123,
      "destinationCurrencyCode": "<string>",
      "externalCustomerId": "<string>",
      "externalReferenceId": "<string>",
      "externalSessionId": "<string>",
      "externalSubaccountCustomerId": "<string>",
      "fiatAmountInUsd": 123,
      "isImported": true,
      "isPassthrough": true,
      "key": "<string>",
      "multiFactorAuthorizationStatus": [
        {
          "method": "SMS",
          "submitted": true,
          "successful": true,
          "url": "<string>"
        }
      ],
      "orderId": "<string>",
      "parentPaymentTransactionId": "<string>",
      "passthroughReference": "<string>",
      "paymentDetails": {
        "authAmount": 123,
        "captureAmount": 123
      },
      "paymentMethodType": "<string>",
      "serviceProviderCreatedAt": "2023-11-07T05:31:56Z",
      "serviceProviderDetails": {},
      "serviceProviderTransactionUrl": "<string>",
      "serviceTransactionId": "<string>",
      "sessionClientTags": {},
      "sourceAmount": 123,
      "sourceCurrencyCode": "<string>",
      "subaccountCustomerId": "<string>"
    }
  ]
}

GET

payments

transactions

Search transactions

curl --request GET \
  --url https://api-sb.meld.io/payments/transactions \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api-sb.meld.io/payments/transactions', 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-sb.meld.io/payments/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <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-sb.meld.io/payments/transactions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api-sb.meld.io/payments/transactions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "count": 123,
  "remaining": 123,
  "totalCount": 123,
  "transactions": [
    {
      "createdAt": "2023-11-07T05:31:56Z",
      "id": "<string>",
      "serviceProvider": "<string>",
      "sessionId": "<string>",
      "status": "<string>",
      "transactionType": "<string>",
      "updatedAt": "2023-11-07T05:31:56Z",
      "accountId": "<string>",
      "apiAccessProfileId": "<string>",
      "countryCode": "<string>",
      "cryptoDetails": {
        "blockchainTransactionId": "<string>",
        "chainId": "<string>",
        "institution": "<string>",
        "networkFee": 123,
        "networkFeeInUsd": 123,
        "offrampDestinationWalletAddress": "<string>",
        "partnerFee": 123,
        "partnerFeeInUsd": 123,
        "swapFee": 123,
        "swapFeeInUsd": 123,
        "totalFee": 123,
        "totalFeeInUsd": 123,
        "transactionFee": 123,
        "transactionFeeInUsd": 123,
        "walletAddress": "<string>"
      },
      "customer": {
        "accountId": "<string>",
        "addresses": [
          {
            "addressDetails": {
              "city": "<string>",
              "country": "<string>",
              "firstName": "<string>",
              "lastName": "<string>",
              "lineOne": "<string>",
              "lineTwo": "<string>",
              "postalCode": "<string>",
              "region": "<string>"
            },
            "type": "BILLING"
          }
        ],
        "email": "<string>",
        "externalId": "<string>",
        "id": "<string>",
        "name": {
          "firstName": "<string>",
          "lastName": "<string>"
        },
        "phone": "<string>",
        "serviceProviders": {},
        "status": "<string>"
      },
      "description": "<string>",
      "destinationAmount": 123,
      "destinationCurrencyCode": "<string>",
      "externalCustomerId": "<string>",
      "externalReferenceId": "<string>",
      "externalSessionId": "<string>",
      "externalSubaccountCustomerId": "<string>",
      "fiatAmountInUsd": 123,
      "isImported": true,
      "isPassthrough": true,
      "key": "<string>",
      "multiFactorAuthorizationStatus": [
        {
          "method": "SMS",
          "submitted": true,
          "successful": true,
          "url": "<string>"
        }
      ],
      "orderId": "<string>",
      "parentPaymentTransactionId": "<string>",
      "passthroughReference": "<string>",
      "paymentDetails": {
        "authAmount": 123,
        "captureAmount": 123
      },
      "paymentMethodType": "<string>",
      "serviceProviderCreatedAt": "2023-11-07T05:31:56Z",
      "serviceProviderDetails": {},
      "serviceProviderTransactionUrl": "<string>",
      "serviceTransactionId": "<string>",
      "sessionClientTags": {},
      "sourceAmount": 123,
      "sourceCurrencyCode": "<string>",
      "subaccountCustomerId": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

default:BASIC <Meld API Key>

required

Headers

Meld-Version

string

Dated API version to use for this request, e.g. 2026-02-03.

Example:

"2023-12-19"

Query Parameters

statuses

string

Comma separated list of transaction status.

If present, only transactions with the specified status will be included.

Possible values:

PENDING_CREATED

PENDING

PROCESSING

AUTHORIZED

AUTHORIZATION_EXPIRED

SETTLING

ONRAMP_SETTLED

SETTLED

REFUNDED

DECLINED

CANCELLED

FAILED

ERROR

VOIDED

TWO_FA_REQUIRED

TWO_FA_PROVIDED

serviceProviders

string

Comma separated list of service providers.

Return only transactions with these specific providers. You can specify multiple service providers in the query string and separate them with commas

Reference Crypto supported service providers and Fiat supported service providers for a full list of supported service providers

limit

integer<int32>

Limits number of returned accounts.

Default value: 10 or the number of ids provided

Minimum value: 1

Maximum value: 100

amountFrom

number

Return only transactions with the amount equal to or greater than this amount

amountTo

number

Return only transactions with the amount equal to or less than this amount

from

string

Return only transactions created after this DateTime. The correct string will use the ISO DateTime or ISO Date Format.

Ex:2021-08-31T01:30:00 or 2022-02-25 are accepted

string

Return only transactions created before this DateTime. The correct string will use the ISO DateTime or ISO Date Format.

Ex:2021-08-31T01:30:00 or 2022-02-25 are accepted

before

string

The unique key corresponding to a payment transaction's position in the paginated list of results -- used to indicate that only payment transactions residing before this key will be retrieved.

Each payment transaction carries a unique key. Reference PaginationThe before and after fields cannot be used in the same request.

after

string

The unique key corresponding to a payment transaction's position in the paginated list of results -- used to indicate that only payment transactions residing after this key will be retrieved.

Each payment transaction carries a unique key. Reference PaginationThe before and after fields cannot be used in the same request.

apiAccessProfileIds

string

Comma separated list of API access profile ids

customerIds

string

Meld generated unique identifier for your customer. This should be used to track customer activity. This takes a comma separated list of customer ids.

externalCustomerIds

string

Your unique identifier for your customer. If maintaining your own customer management system this can also be used for tracking customer activity. This takes a comma separated list of external customer ids.

sessionIds

string

Comma separated list of session ids

externalSessionIds

string

Comma separated list of external session ids

externalReferenceIds

string

Comma separated list of reference ids

types

string

Comma separated list of transaction types

orderIds

string

Comma separated list of order ids (for virtual account ramp)

serviceProviderTransactionId

string

service provider transaction id

Response

Payment transaction found

count

integer<int32>

Number of payment transactions returned.

remaining

integer<int32>

Number of payment transactions before/after this page, depending the direction this page was selected.

totalCount

integer<int32>

Total number of payment transactions.

transactions

object[]

List of transactions

Show child attributes

Crypto

Bank Linking

Payments

Customer

Service Providers

Webhooks

Beta

Search transactions

Authorizations

Headers

Query Parameters

Response