Consulta de Título Público

Retorna uma boleta de título público pelo operation_key, com o histórico de status. Use para acompanhar a aprovação, o registro no SELIC e a liquidação da operação.

Disponível em

Perfil	Host	Permissão exigida
Gestora	manager-api	Leitura

URL base de cada host: Ambientes (Hosts).

Request

ENDPOINT

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

MÉTODO

GET

Path params

Parâmetro	Tipo	Descrição
fund_class_key	string	Identificador único do fundo.
operation_key	string	Identificador da operação devolvido na criação da boleta.

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"
        }
    ]
}

Atributos da resposta

Os mesmos campos da criação da boleta, mais:

Campo	Tipo	Descrição
status	string	Status atual. Veja os status da operação.
status_events	array	Histórico de status, com status, metadata e datetime de cada mudança.
selic_operation_id, selic_specification_id, selic_command_number	string	Identificadores no SELIC. Presentes depois do registro.
yearly_negotiated_rate, return_date, return_unit_price, total_return_value	number / string	Dados do retorno. Presentes em buyback_operation.
time_exception_reason	string	Justificativa de horário, quando houver.
time_exception_released_at	string	Data e hora em que a QI Tech liberou a boleta fora do horário.

Erros

Status	Código	Quando acontece
404	TTR000013	Não existe operação com este operation_key no fundo.
404	TTR000004	A fund_class_key não existe.
403	TTR000040	O fundo não pertence à sua gestora.

Erros de autenticação, permissão e host: veja Erros da API.