Query Extraordinary Amortization
This endpoint returns a specific extraordinary amortization by its key (extraordinary_event_conciliation_key). Use it to follow the conciliation status of the event — from pending_conciliation (not yet paid or partially paid) through to the terminal state (paid or canceled) defined by QI Tech's internal orchestration.
The query is date-agnostic and does not trigger any status transition: it only reflects the current state of the event and of each linked instalment.
Request
Path Params
| Field | Type | Required | Description |
|---|---|---|---|
extraordinary_event_conciliation_key | string (UUID) | Yes | Unique key of the extraordinary amortization event to be queried. |
Example call:
GET /event_conciliation/extraordinary_event/11111111-1111-4111-8111-111111111111
Response
Response Body
{
"extraordinary_event_conciliation_key": "11111111-1111-4111-8111-111111111111",
"security_key": "971380d4-469e-48f6-a64b-3afb8a88109e",
"investment_key": "44444444-4444-4444-8444-444444444444",
"amortization_type": "early_amortization",
"total_expected_amount": 1500.00,
"total_discount_amount": 0,
"total_paid_amount": 0.0,
"status": "pending_conciliation",
"reference_date": "2026-04-24",
"due_date": "2026-04-24",
"paid_at": null,
"event_conciliation_list": [
{
"event_conciliation_key": "22222222-2222-4222-8222-222222222222",
"installment_key": "33333333-3333-4333-8333-333333333333",
"event_conciliation_status": "pending_conciliation",
"event_conciliation_type": "extraordinary_event"
}
]
}
Response Body Params
| Field | Type | Description |
|---|---|---|
extraordinary_event_conciliation_key | string (UUID) | Key of the extraordinary amortization event queried. |
security_key | string (UUID) | Key of the asset (security) the event belongs to. |
investment_key | string (UUID) | Key of the investment targeted by the event. |
amortization_type | string | Amortization type of the event — echoes the value used on creation. |
total_expected_amount | number | Total expected amount of the event (sum distributed across the instalments) in BRL. |
total_discount_amount | number | Total discount applied. Different from zero only for present_amount. |
total_paid_amount | number | Amount already conciliated for the event (in BRL). 0 while no payment has been confirmed; > 0 on partial payment. |
status | string | Current status of the event: pending_conciliation, paid or canceled. |
reference_date | string (date) | Reference date informed on creation. |
due_date | string (date) | Target settlement date informed on creation. |
paid_at | string (date) | Date on which the event was settled. null while it is not paid. |
event_conciliation_list | array | List of event_conciliation (conciliation event of each instalment) of the event. event_conciliation_list object. |
event_conciliation_list object
| Field | Type | Description |
|---|---|---|
event_conciliation_key | string (UUID) | Key of the instalment conciliation event (event_conciliation). |
installment_key | string (UUID) | Key of the instalment affected by this conciliation event. |
event_conciliation_status | string | Current status of the instalment conciliation event (pending_conciliation, paid, canceled). |
event_conciliation_type | string | Type of the event_conciliation. Always extraordinary_event for events created by this flow. |
The status (and each instalment's event_conciliation_status) reflects the current state at the moment of the query. The transition to paid or canceled is performed by QI Tech's internal orchestration — the integrator does not need to call any endpoint for that.
Errors
| Code | HTTP | Meaning |
|---|---|---|
| EVC100011 | 404 | No extraordinary amortization found for the informed extraordinary_event_conciliation_key. |
Refer to the Error catalog for complete resolution.