Skip to main content
GET
/
api
/
partner
/
v2
/
transactions
cURL
curl --request GET \
  --url https://staging-api.capa.fi/api/partner/v2/transactions \
  --header 'partner-api-key: <partner-api-key>'
{
  "success": true,
  "data": {
    "count": 2,
    "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,
        "createdAt": "2025-05-08T18:00:00Z",
        "completedAt": "2025-05-08T18:12:00Z",
        "destinationWalletAddress": "0xabc123...",
        "bankAccount": {
          "country": "MX",
          "accountIdentifier": "0146...",
          "bankName": "Santander",
          "accountType": "SAVINGS",
          "isVerified": true,
          "documentIdentifier": "123abc",
          "bic": "DEUTDEFF",
          "iban": "DE89370400440532013000",
          "routingNumber": "021000021"
        },
        "invoice": {
          "transactionHash": "0xabc123...",
          "paymentUrl": "https://cdn.example.com/invoice"
        },
        "cancellationReason": "Transaction cancelled by user",
        "crossFiatCurrency": "<string>",
        "crossFiatAmount": 123,
        "sourceCurrency": "<string>",
        "targetCurrency": "<string>",
        "sourceAmount": 123,
        "targetAmount": 123,
        "sourceBankAccount": {
          "country": "MX",
          "accountIdentifier": "0146...",
          "bankName": "Santander",
          "accountType": "SAVINGS",
          "isVerified": true,
          "documentIdentifier": "123abc",
          "bic": "DEUTDEFF",
          "iban": "DE89370400440532013000",
          "routingNumber": "021000021"
        },
        "targetBankAccount": {
          "country": "MX",
          "accountIdentifier": "0146...",
          "bankName": "Santander",
          "accountType": "SAVINGS",
          "isVerified": true,
          "documentIdentifier": "123abc",
          "bic": "DEUTDEFF",
          "iban": "DE89370400440532013000",
          "routingNumber": "021000021"
        }
      }
    ]
  }
}

Headers

​
partner-api-key
string
required

Api key for the affiliated partner that is performing the request

Query Parameters

​
id
string

Transaction identifier

Example:

"8374f327-38bd-4b0b-b8a7-2524599eb903"

​
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,
EXPIRED,
CANCELLED,
IN_PROGRESS,
BANK_TRANSFER_PENDING,
READY_BANK_TRANSFER,
AWAITING_MANUAL_CRYPTO_TRANSFER,
AWAITING_MANUAL_FIAT_TRANSFER,
PENDING_FUNDS,
FUNDS_RECEIVED,
AWAITING_FUND_TRANSFER
Example:

"PENDING"

​
type
enum<string>

Transaction type

Available options:
ON_RAMP,
OFF_RAMP,
CROSS_RAMP
Example:

"ON_RAMP"

​
fiatCurrency
enum<string>

Fiat currency code

Available options:
MXN,
DOP,
USD,
EUR
Example:

"MXN"

​
userId
string

User id

Example:

"8374f327-38bd-4b0b-b8a7-2524599eb903"

​
partnerId
string

Partner identifier

Example:

"8374f327-38bd-4b0b-b8a7-2524599eb903"

​
skip
number

The number of elements to exclude from the results.

Example:

5

​
limit
number

The maximum amount of results to return.

Example:

5

​
sortBy
string

Supported values:

  • createdAt
Example:

"createdAt"

Response

200 - application/json

Retrieves transactions of the user associated with the current partner

​
success
boolean
Example:

true

​
data
object