Compose Finance
Transactions

Get customer transactions

Returns the transaction history for a specific customer. Only includes DEPOSIT and WITHDRAWAL transactions.

GET
/api/v2/customers/{customerId}/transactions

Returns the transaction history for a specific customer. Only includes DEPOSIT and WITHDRAWAL transactions.

Authorization

bearerAuth
AuthorizationBearer <token>

Organization API key obtained from PropelAuth

In: header

Path Parameters

customerId*string

Unique identifier of the customer

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET 'https://compose.finance/api/v2/customers/{customerId}/transactions' \  -H 'Authorization: Bearer YOUR_API_KEY'
[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "type": "DEPOSIT",
    "status": "COMPLETED",
    "createdAt": "2024-01-15T10:30:00.000Z",
    "completedAt": "2024-01-15T10:35:00.000Z",
    "reference": "FLGVNY3H9F",
    "sourceCurrency": "EUR",
    "targetCurrency": "USDC",
    "sourceAmount": "1000",
    "targetAmount": "1157.43",
    "exchangeRate": "1.1691279887",
    "fee": "1",
    "depositInstructions": {
      "accountType": "sharedAccount",
      "reference": "FLGVNY3H9F"
    },
    "walletAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "developerFee": {
      "developerSpreadFeeBps": 100,
      "amount": "2.50"
    },
    "txHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
  },
  {
    "id": "cltx456def789xyz012",
    "type": "WITHDRAWAL",
    "status": "PROPOSED",
    "requiresUiAction": true,
    "createdAt": "2024-01-20T14:00:00.000Z",
    "completedAt": null,
    "reference": "cltx456def789xyz012",
    "sourceCurrency": "USDC",
    "targetCurrency": "EUR",
    "sourceAmount": "500",
    "targetAmount": "432.5",
    "exchangeRate": "0.865",
    "fee": "2.5",
    "withdrawalBank": {
      "id": "bank_123abc",
      "beneficiaryName": "JOHN DOE",
      "iban": "DE89370400440532013000"
    },
    "walletAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "developerFee": null,
    "txHash": null
  }
]
{
  "error": "Unauthorized - Invalid or missing API key or session"
}
{
  "error": "Customers feature is not enabled for your organization"
}
{
  "error": "Customer not found"
}
{
  "error": "Internal server error"
}

Get customer transaction GET

Returns details for a specific customer transaction. Use this to check the current status of a withdrawal or deposit. **Status Values** - `PROCESSING` — Transaction is being processed - `PROPOSED` — Awaiting approval in dashboard - `PARTIALLY_SIGNED` — If multiple approvers configured: requires more approvals. - `COMPLETED` — Successfully completed - `FAILED` — Transaction failed - `CANCELLED` — Cancelled by user - `EXPIRED` — Expired before completion **Action Required** When `requiresUiAction` is `true`, the transaction needs user approval in the dashboard.

Verify Ethereum address POST

Validates an Ethereum address and provides information about its type. **Checks Performed** - Address format validation (checksum) - Contract detection (checks if address has deployed code) - Safe wallet identification (checks if it's a Gnosis Safe multisig) **Use Cases** - Validate customer wallet addresses before saving - Detect if a recipient is a smart contract - Identify Safe wallets for display purposes