List Transactions

cURL

curl --request GET \
  --url https://api.sandbox.capa.fi/api/partner/v2/transactions \
  --header 'partner-api-key: <api-key>'

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

fetch('https://api.sandbox.capa.fi/api/partner/v2/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.sandbox.capa.fi/api/partner/v2/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 => [
    "partner-api-key: <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.sandbox.capa.fi/api/partner/v2/transactions"

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

	req.Header.Add("partner-api-key", "<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.sandbox.capa.fi/api/partner/v2/transactions")

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

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

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

{
  "success": true,
  "data": {
    "count": 1,
    "data": [
      {
        "id": "tx-1",
        "userId": "user-123",
        "status": "PENDING_PAYMENT",
        "type": "ON_RAMP",
        "tokenSymbol": "USDC",
        "blockchainSymbol": "POL",
        "fiatCurrency": "MXN",
        "fiatAmount": 5000,
        "cryptoAmount": 251.2,
        "exchangeRate": 19.9,
        "premiumSpread": 0.01,
        "forwardingDays": 2,
        "effectiveForwardingDays": 4,
        "forwardingSettlementDate": "2026-03-14T03:25:27.495Z",
        "createdAt": "2025-05-08T18:00:00Z",
        "completedAt": null,
        "destinationWalletAddress": "0x7796d4f304bd84171ee6730ad0f69c07a47e786d",
        "bankAccount": {
          "country": "MX",
          "accountIdentifier": "014680260346007120",
          "bankName": "Santander",
          "accountType": "SAVINGS",
          "isVerified": true
        }
      }
    ]
  }
}

GET

api

partner

transactions

cURL

curl --request GET \
  --url https://api.sandbox.capa.fi/api/partner/v2/transactions \
  --header 'partner-api-key: <api-key>'

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

fetch('https://api.sandbox.capa.fi/api/partner/v2/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.sandbox.capa.fi/api/partner/v2/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 => [
    "partner-api-key: <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.sandbox.capa.fi/api/partner/v2/transactions"

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

	req.Header.Add("partner-api-key", "<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.sandbox.capa.fi/api/partner/v2/transactions")

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

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

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

{
  "success": true,
  "data": {
    "count": 1,
    "data": [
      {
        "id": "tx-1",
        "userId": "user-123",
        "status": "PENDING_PAYMENT",
        "type": "ON_RAMP",
        "tokenSymbol": "USDC",
        "blockchainSymbol": "POL",
        "fiatCurrency": "MXN",
        "fiatAmount": 5000,
        "cryptoAmount": 251.2,
        "exchangeRate": 19.9,
        "premiumSpread": 0.01,
        "forwardingDays": 2,
        "effectiveForwardingDays": 4,
        "forwardingSettlementDate": "2026-03-14T03:25:27.495Z",
        "createdAt": "2025-05-08T18:00:00Z",
        "completedAt": null,
        "destinationWalletAddress": "0x7796d4f304bd84171ee6730ad0f69c07a47e786d",
        "bankAccount": {
          "country": "MX",
          "accountIdentifier": "014680260346007120",
          "bankName": "Santander",
          "accountType": "SAVINGS",
          "isVerified": true
        }
      }
    ]
  }
}

Returns a paginated list of on-ramp, off-ramp, and cross-ramp transactions belonging to your partner account. Use query parameters to filter by status, type, user, receiver, or currency.

Important Notes

Scoped access: You can only retrieve transactions created via your own partner credentials.
Pagination: Use skip and limit to paginate. limit must not exceed 100 (defaults to 20).
Combine filters such as status, type, userId, and receiverId freely.

Use Cases

User dashboards: Display past transactions per user.
Reconciliation: Fetch completed transactions for accounting.
Customer support: Inspect and manage pending transactions.

Error Codes

Common Errors

HTTP Status	Code	Message
401	`UNAUTHORIZED`	”API Key is missing”
401	`UNAUTHORIZED`	”Invalid API Key format”
401	`UNAUTHORIZED`	”Invalid API Key”
403	`INVALID_PARTNER_FLOW`	”The partner has an invalid flow.”

Endpoint-Specific Errors

HTTP Status	Code	Message
400	`INVALID_USER_INPUT_ERROR`	”Invalid User Input”

Authorizations

partner-api-key

string

header

required

API key for the affiliated partner performing the request.

Query Parameters

string

Transaction identifier

status

enum<string>

Transaction status

Available options:

FAILED,

COMPLETED,

PENDING,

PENDING_PAYMENT,

FIAT_PAYMENT_RECEIVED,

FIAT_RECEIVED,

CRYPTO_RECEIVED,

CRYPTO_NOT_RECEIVED,

COMPLETED_CRYPTO_RECEIVAL,

CANCELLED,

IN_PROGRESS,

BANK_TRANSFER_PENDING,

READY_BANK_TRANSFER,

AWAITING_MANUAL_CRYPTO_TRANSFER,

AWAITING_MANUAL_FIAT_TRANSFER,

PENDING_FUNDS,

FUNDS_RECEIVED,

AWAITING_FUND_TRANSFER

type

enum<string>

Transaction type

Available options:

ON_RAMP,

OFF_RAMP,

CROSS_RAMP

fiatCurrency

enum<string>

Fiat currency code

Available options:

MXN,

DOP,

USD,

EUR

userId

string

User id

partnerId

string

Partner identifier

receiverId

string

Receiver identifier to filter transactions by receiver

skip

number

The number of elements to exclude from the results.

limit

number

The maximum amount of results to return.

sortBy

string

Supported values:

createdAt

Response

Retrieves transactions of the user associated with the current partner

success

boolean

Example:

true

data

object

Show child attributes

Cancel Transaction Mock Testing Guide

⌘I

​Important Notes

​Use Cases

​Error Codes

​Common Errors

​Endpoint-Specific Errors

Authorizations

Query Parameters

Response

Important Notes

Use Cases

Error Codes

Common Errors

Endpoint-Specific Errors