GET Financial Transactions¶

Endpoint¶

GET /api/affiliate/v1/transactions

Requires an affiliate API token with transactions:read.

GET /api/affiliate/v1/transactions?limit=100&cursor=900&type=0&status=3&from_time=1789344000&to_time=1791936000
Authorization: {JWT_TOKEN}

The server first resolves customers attributed to the token's affiliate and brand. A transaction is included only when its customer_id belongs to that set, or when its trading account login is linked to one of those customers. The login fallback supports older transaction records without a customer id.

Query parameters¶

Name	Type	Required	Description
`limit`	int	No	Page size, default `100`, maximum `500`
`cursor`	int	No	Return records with a lower transaction id
`type`	int	No	`0` deposit, `1` withdrawal
`status`	int	No	Cashier transaction status code
`from_time`	int64	No	Minimum creation time, Unix timestamp
`to_time`	int64	No	Maximum creation time, Unix timestamp

Response¶

{
  "rows": [
    {
      "id": 899,
      "customer_id": 12041,
      "login": 2000041,
      "type": 0,
      "type_name": "deposit",
      "status": 3,
      "status_name": "credited",
      "provider": "stripe",
      "method": "card",
      "amount": 250.0,
      "currency": "USD",
      "account_currency": "USD",
      "converted_amount": 250.0,
      "conversion_rate": 1.0,
      "created_time": 1789344000,
      "processed_time": 1789344012
    }
  ],
  "has_more": false,
  "next_cursor": 899
}

The response excludes provider payment identifiers, idempotency keys, raw metadata, internal comments, failure or rejection details, and staff identifiers.

Errors¶

HTTP	Error	Description
`401`	`INCORRECT_TOKEN`	JWT signature or format is invalid
`401`	`INVALID_AFFILIATE_API_TOKEN`	Token record, owner, brand, scope, expiration, or active access check failed