Public Security Query

Returns a public securities ticket by its operation_key, with the status history. Use it to track the approval, the registration in SELIC and the settlement of the operation.

Available on

Profile	Host	Required permission
Manager	manager-api	Read

Base URL for each host: Environments (Hosts).

Request

ENDPOINT

/trade_treasury/fund_class/{fund_class_key}/operation/{operation_key}

METHOD

GET

Path params

Parameter	Type	Description
fund_class_key	string	Unique identifier of the fund.
operation_key	string	Operation identifier returned at the ticket creation.

Response

STATUS

200

Response Body

{
    "operation_key": "85cfd700-54a4-40f4-bc61-2ece992864ea",
    "external_id": "a3f1c2e4-7b8d-4e6f-9a0b-1c2d3e4f5a6b",
    "fund_class": {
        "fund_class_key": "5122bf31-660a-4f61-a447-38e5e17162dd",
        "manager_key": "bea7581a-f901-4995-a486-46e18ae61aab",
        "name": "FUNDO EXEMPLO DTVM",
        "document_number": "11.222.333/0001-81",
        "accounting_date": "2025-12-04",
        "internal_transfer_for_main_account": false
    },
    "status": "pending_registration",
    "operation_part": "assignee",
    "operation_type": {
        "enumerator": "outright_operation",
        "code": 1052
    },
    "treasury": {
        "enumerator": "ntn_b",
        "code": 760199
    },
    "operation_date": "2025-12-04",
    "payment_date": "2025-12-04",
    "maturity_date": "2035-05-15",
    "total_operation_value": 12345.67,
    "units": 10,
    "unit_price": 1234.567891,
    "counterparty": {
        "iselic_number": "33444555",
        "document_number": "33.444.555/0001-81",
        "selic_account_number": "123456789"
    },
    "isin_code": "BRSTNCNTB633",
    "issue_date": "2025-11-04",
    "operation_data": {},
    "status_events": [
        {
            "status": "pending_manager_approval",
            "metadata": {},
            "datetime": "2025-12-04 13:10:00.000000"
        },
        {
            "status": "pending_registration",
            "metadata": {},
            "datetime": "2025-12-04 13:25:00.000000"
        }
    ]
}

Response attributes

The same fields as the ticket creation, plus:

Field	Type	Description
status	string	Current status. See the operation statuses.
status_events	array	Status history, with the status, metadata and datetime of each change.
selic_operation_id, selic_specification_id, selic_command_number	string	Identifiers in SELIC. Present after registration.
yearly_negotiated_rate, return_date, return_unit_price, total_return_value	number / string	Return data. Present in buyback_operation.
time_exception_reason	string	Time justification, when there is one.
time_exception_released_at	string	Date and time when QI Tech released the ticket outside the cut-off time.

Errors

Status	Code	When it happens
404	TTR000013	There is no operation with this operation_key in the fund.
404	TTR000004	The fund_class_key does not exist.
403	TTR000040	The fund does not belong to your manager.

Authentication, permission and host errors: see API Errors.