Retrieve statement

Returns the paginated statement of your commission position's movements: credits per settled installment, cancellation clawbacks and payout settlements. Each commission movement is correlated to the policy that originated it through the policy_key.

Request

ENDPOINT

/finance/v1/statement

METHOD

GET

Query params

Parameter	Type	Required	Description
page	integer	optional	Page number. Default: 1.
page_size	integer	optional	Records per page. Default: 50. Maximum: 200.
from	string	optional	Minimum movement date (YYYY-MM-DD).
to	string	optional	Maximum movement date (YYYY-MM-DD).

Example call

GET /finance/v1/statement?from=2026-07-01&to=2026-07-31&page=1&page_size=50

Response

STATUS

200

Response Body

{
  "items": [
    {
      "event_type": "REQUESTER_COMMISSION_BOOKED",
      "amount": "14.64",
      "policy_key": "0b6e7c1a-9a4e-4c1e-b1d4-2f5a8c9e0d31",
      "installment_number": 1,
      "occurred_at": "2026-07-20T14:05:01.000Z"
    },
    {
      "event_type": "REQUESTER_CLAWBACK_BOOKED",
      "amount": "-14.64",
      "policy_key": "0b6e7c1a-9a4e-4c1e-b1d4-2f5a8c9e0d31",
      "occurred_at": "2026-07-25T11:00:00.000Z"
    },
    {
      "event_type": "TRANSFER_SETTLED",
      "amount": "-980.10",
      "transfer_key": "3c4d5e6f-7a8b-4c9d-0e1f-2a3b4c5d6e7f",
      "occurred_at": "2026-07-21T09:00:12.000Z"
    }
  ],
  "page": 1,
  "page_size": 50,
  "total": 3
}

Response attributes

Field	Type	Description
items	array	Movements of your position, newest first.
page	integer	Current page.
page_size	integer	Requested page size.
total	integer	Total number of movements in the period.

Object in items

Field	Type	Description
event_type	string	Movement type. See the type table below.
amount	string	Signed amount: positive credits the position, negative debits it (clawbacks and payout settlements).
policy_key	string	Policy that originated the movement. Present on commission credits and clawbacks.
installment_number	integer	Number of the settled installment that originated the credit. Present on commission credits.
transfer_key	string	Corresponding payout. Present on payout settlements.
occurred_at	string	Instant of the movement.

Movement types

event_type	Sign	Meaning
REQUESTER_COMMISSION_BOOKED	+	Commission credited over a settled premium installment.
REQUESTER_CLAWBACK_BOOKED	−	Commission clawback due to the cancellation of a policy with a premium refund.
TRANSFER_SETTLED	−	Payout settled to your account — the position is debited by the transferred amount.
MANUAL_ADJUSTMENT	+/−	Operational adjustment booked by QI Tech (e.g. incident resolution).

Possible errors

Status	Description
400	Invalid filter or pagination parameter.
401 / 403	Authentication or authorization failure.
500 / 503	Internal error or service unavailable — safe to retry.