Non-breaking API update: New Response fields for /v2/transactions and /v2/balance-statements

Effective date: 31 October 2025

Overview

We're adding new aggregated fields to the v2 transactions response and a new summary object to the v2 balance statements response. These are additive, backward-compatible changes. No request parameters, pagination, status codes, or rate limits are affected.

Endpoints impacted

• GET /v2/transactions
• GET /v2/balance-statements

What's changing

/v2/transactions

New fields in the top-level meta object:

"meta": {
  "transaction_count": "0",
  "total_amount": "0",
  "total_price": "0",
  "profit": "0",
  "failed_count": "0",
  "successful_count": "311",
  "pending_count": "0",
  "refund_count": "0"
}

/v2/balance-statements

New object added to the response:

"summary": {
  "total_transactions": {
    "amount": -3444.4284,
    "count": 65000
  },
  "total_deposit": {
    "amount": 5000.00,
    "count": 17
  },
  "total_refund": {
    "amount": 150.00,
    "count": 5
  }
}

Backward compatibility

• Non-breaking; existing fields and formats are unchanged.
• New fields are additive only. Responses that previously parsed will continue to parse.
• If you use strict JSON schema/model validation, update your models to include the new meta fields on /v2/transactions and the summary object on /v2/balance-statements, or configure them to ignore unknown properties.

Actions for integrators

• No action required to maintain existing functionality.

Should you require any further assistance or additional information, please do not hesitate to reach out to us via email at support@iimmpact.com.