Compose Finance
Transactions

Get customer transaction

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.

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

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.

Authorization

bearerAuth
AuthorizationBearer <token>

Organization API key obtained from PropelAuth

In: header

Path Parameters

customerId*string

Unique identifier of the customer

transactionId*string

Unique identifier of the transaction

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET 'https://compose.finance/api/v2/customers/{customerId}/transactions/{transactionId}' \  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "id": "txn_abc123",
  "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"
}

{
  "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 an indicative rate quote GET

Preview the exchange rate, fees, and estimated amounts for a deposit or withdrawal before initiating the transaction. Rates are indicative and not locked — the actual rate is determined when the transaction is executed. Provide exactly one of `source_amount` or `target_amount`. Supported currencies: fiat (`EUR`) and stablecoin (`USDC`, `EURC`).

Get customer transactions GET

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