cURL
curl --request GET \
--url https://api.sandbox.capa.fi/api/partner/v2/transactions \
--header 'partner-api-key: <api-key>'import requests
url = "https://api.sandbox.capa.fi/api/partner/v2/transactions"
headers = {"partner-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)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))
}HttpResponse<String> response = Unirest.get("https://api.sandbox.capa.fi/api/partner/v2/transactions")
.header("partner-api-key", "<api-key>")
.asString();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
}
}
]
}
}Transactions
List Transactions
GET
/
api
/
partner
/
v2
/
transactions
cURL
curl --request GET \
--url https://api.sandbox.capa.fi/api/partner/v2/transactions \
--header 'partner-api-key: <api-key>'import requests
url = "https://api.sandbox.capa.fi/api/partner/v2/transactions"
headers = {"partner-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)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))
}HttpResponse<String> response = Unirest.get("https://api.sandbox.capa.fi/api/partner/v2/transactions")
.header("partner-api-key", "<api-key>")
.asString();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, or currency.
Important Notes
- Scoped access: You can only retrieve transactions created via your own partner credentials.
- Pagination: Use
skipandlimitto paginate.limitmust not exceed 100 (defaults to 20). - Combine filters such as
status,type, anduserIdfreely.
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
API key for the affiliated partner performing the request.
Query Parameters
Transaction identifier
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 Transaction type
Available options:
ON_RAMP, OFF_RAMP, CROSS_RAMP Fiat currency code
Available options:
MXN, DOP, USD, EUR User id
Partner identifier
The number of elements to exclude from the results.
The maximum amount of results to return.
Supported values:
- createdAt