Operation Query by Key
This endpoint allows querying the complete details of a specific operation using its unique key.
Operation Query (GET)
Request
ENDPOINT
/commercial_paper/operation/OPERATION-KEYMETHOD
GETPath Params
| Field | Type | Description | Characters |
|---|---|---|---|
OPERATION-KEY | string | Unique operation key (UUID v4). | 36 |
Response
STATUS
200Response Body
{
"tenant_key": "13a6a1d5-7a3c-4627-a0a6-9fd746662ca4",
"operation_key": "dc368e4d-c288-4971-ad8d-5c9c31616e74",
"operation_type": "commercial_paper",
"operation_status": "issued",
"backoffice_analysis_status": "approved",
"issuer_key": "9e08fd62-ce43-4c95-99e0-4386e980d618",
"issuer_name": "Blue Logic",
"issuer_document_number": "97.923.586/0001-06",
"issuer_bank_account": {
"account_type": "checking",
"account_digit": "3",
"account_branch": "0001",
"account_number": "4464541",
"financial_institution_ispb": "32402502",
"financial_institution_code_number": "329"
},
"issuer_onboarding_approved": true,
"issue_number": 1,
"issue_series": 1,
"contract_number": "0000000001",
"issue_date": "2025-02-03",
"financial_base_date": "2025-02-03",
"commercial_paper_template_key": "68956441-d46c-44ed-93b9-b1806dd6ada9",
"commercial_paper_document_key": "dc368e4d-c288-4971-ad8d-5c9c31616e74/commercial_paper/2cb87abc-8bdf-4df3-be98-b7afb53b14c8",
"adhesion_term_template_key": "58743ab9-99bd-439a-93af-16e4c5fccd6f",
"adhesion_term_document_key": "dc368e4d-c288-4971-ad8d-5c9c31616e74/adhesion_term/fe74eaed-2f44-45b4-b972-83fa222cbf1c",
"envelope_signature_status": "signed",
"envelope_key": "4d7f28b4-185f-482d-929e-d1af937cb27b",
"envelope_signature_url": "https://sandbox.certifiqi.com.br/sign?batch-group=c4747fe6-2cc0-41a9-8972-84b44f8fff8a",
"envelope_signed_files_key": "dc368e4d-c288-4971-ad8d-5c9c31616e74/signed_files",
"financial": {
"financial_base_date": "2025-02-03",
"issue_quantity": 1000000,
"unit_price": 1.0,
"issue_amount": 1000000.0,
"released_amount": 1000000.0,
"cet": 5.0,
"annual_cet": 79.59,
"number_of_installments": 5,
"prefixed_interest_rate": {
"daily_rate": 0.0016053474,
"annual_rate": 0.795856326,
"monthly_rate": 0.05,
"interest_base": "calendar_days_365"
},
"fine_delay_rate": {
"monthly_rate": 0.01,
"interest_base": "calendar_days_365"
},
"contract_fine_rate": 0.02,
"financial_index": null,
"post_fixed_interest_rate": null,
"fees": [
{
"type": "internal",
"amount": 2.0,
"fee_type": "implementation_fee",
"fee_amount": 20000.0,
"amount_type": "percentage"
},
{
"type": "external",
"amount": 5.0,
"fee_type": "implementation_fee",
"fee_amount": 50000.0,
"amount_type": "percentage"
}
],
"installment_list": [
{
"installment_number": 1,
"workdays": 20,
"calendar_days": 30,
"principal_amortization_unit_price": 0.18122484,
"principal_amortization_amount": 181224.84138231,
"interest_amount": 49298.45861769,
"amount": 230523.3,
"due_principal": 1000000.0,
"due_interest": 0.0,
"due_date": "2025-03-05",
"has_interest": true
},
{
"installment_number": 2,
"workdays": 21,
"calendar_days": 29,
"principal_amortization_unit_price": 0.19153595,
"principal_amortization_amount": 191535.95353305,
"interest_amount": 38987.34646695,
"amount": 230523.3,
"due_principal": 818775.15861769,
"due_interest": 0.0,
"due_date": "2025-04-03",
"has_interest": true
},
{
"installment_number": 3,
"workdays": 19,
"calendar_days": 32,
"principal_amortization_unit_price": 0.19748652,
"principal_amortization_amount": 197486.52331007,
"interest_amount": 33036.77668993,
"amount": 230523.3,
"due_principal": 627239.20508464,
"due_interest": 0.0,
"due_date": "2025-05-05",
"has_interest": true
},
{
"installment_number": 4,
"workdays": 21,
"calendar_days": 29,
"principal_amortization_unit_price": 0.21005991,
"principal_amortization_amount": 210059.90840452,
"interest_amount": 20463.39159548,
"amount": 230523.3,
"due_principal": 429752.68177457,
"due_interest": 0.0,
"due_date": "2025-06-03",
"has_interest": true
},
{
"installment_number": 5,
"workdays": 21,
"calendar_days": 30,
"principal_amortization_unit_price": 0.21969277,
"principal_amortization_amount": 219692.77337005,
"interest_amount": 10830.52662995,
"amount": 230523.3,
"due_principal": 219692.77337005,
"due_interest": 0.0,
"due_date": "2025-07-03",
"has_interest": true
}
]
},
"tags": [],
"investor_list": [
{
"investor_key": "a1a75b66-6f7e-4bcc-9ff5-6f8adf7cae09",
"investor_name": "Ultimate Cascade",
"investor_document_number": "31.424.651/0001-32",
"subscription_percentage": 100.0,
"subscription_quantity": 1000000,
"investor_onboarding_approved": true,
"bank_account": {
"account_type": "checking",
"account_digit": "3",
"account_branch": "0001",
"account_number": "33400254",
"financial_institution_ispb": "32402502",
"financial_institution_code_number": "329"
},
"updated_at": null
}
],
"related_party_list": [
{
"related_party_key": "1ac83d43-41cb-4ad0-a7ca-add6c3a3171c",
"name": "Blue Logic",
"document_number": "97.923.586/0001-06",
"role_type": "issuer",
"is_active": true,
"updated_at": null,
"trading_name": "Blue Logic",
"cnae_code": "47.21-1-02",
"company_type": "ltda",
"foundation_date": "2007-10-25",
"person_type": "legal",
"street": "Rua Romualdo de Souza Brito",
"neighborhood": "Centro",
"number": "89",
"postal_code": "08150-470",
"city": "São Paulo",
"state": "SP",
"complement": "Letra C",
"signer_group_list": [
{
"signer_group_key": "fa2cbede-a501-41e1-bf70-078bb0d4ac7b",
"minimum_required_signers": 1,
"signers": [
{
"name": "John Doe",
"email": "123.456.789-00@yopmail.com",
"phone_number": "+5511988887777",
"document_number": "123.456.789-00",
"is_group_mandatory": true
}
]
}
],
"document_list": [],
"contact_information_list": [
{
"name": "John Doe",
"email": "123.456.789-00@yopmail.com",
"is_default": true,
"phone_number": "+5516982399722",
"document_number": "123.456.789-00",
"issuer_contact_information_key": "6e9714f4-d652-4ca0-89e2-13e9e2ec3414"
}
]
},
{
"related_party_key": "bab03c76-a12a-4d88-aaf8-70799e3b1b30",
"name": "Ultimate Cascade",
"document_number": "31.424.651/0001-32",
"role_type": "investor",
"is_active": true,
"updated_at": null,
"trading_name": "Ultimate Cascade",
"cnae_code": "47.21-1-02",
"company_type": "ltda",
"foundation_date": "2007-10-25",
"person_type": "legal",
"street": "Rua Romualdo de Souza Brito",
"neighborhood": "Centro",
"number": "89",
"postal_code": "08150-470",
"city": "São Paulo",
"state": "SP",
"complement": "Letra C",
"signer_group_list": [
{
"signer_group_key": "ccb36b0b-40b5-42e0-bc41-0e8fce57f3ca",
"minimum_required_signers": 1,
"signers": [
{
"name": "John Doe",
"email": "123.456.789-00@yopmail.com",
"phone_number": "+5516982399722",
"document_number": "123.456.789-00",
"is_group_mandatory": true
}
]
}
],
"document_list": [],
"contact_information_list": [
{
"name": "John Doe",
"email": "123.456.789-00@yopmail.com",
"is_default": true,
"phone_number": "+5511988887777",
"document_number": "123.456.789-00",
"investor_contact_information_key": "26299c0f-2127-45d4-b22e-f2b494d2f7ae"
}
]
}
],
"collateral_list": [
{
"collateral_key": "d8fdb578-1e2a-4b79-8267-5b1763e56754",
"collateral_type": "real_estate",
"collateral_data": {
"value": 999
}
}
],
"metadata_list": [
{
"metadata_key": "convenio",
"metadata_value": "12398129038"
}
],
"integralization_key": "d8fdb578-1e2a-4b79-8267-5b1763e56754",
"security_key": "26299c0f-2127-45d4-b22e-f2b494d2f7ae"
}
Response Body Params
| Field | Type | Description | Max Characters |
|---|---|---|---|
tenant_key * | string | Unique tenant key (UUID v4). | 36 |
operation_key * | string | Unique operation key (UUID v4). | 36 |
operation_type * | string | Operation type. commercial_paper | - |
operation_status * | string | Operation status. | operation_status enumerators |
issuer_key * | string | Unique issuer key (UUID v4). | 36 |
issuer_name * | string | Issuer name. | - |
issuer_document_number * | string | Issuer document number (CNPJ). | 18 |
issuer_bank_account * | object | Issuer banking data. | bank_account object |
issuer_onboarding_approved * | boolean | Indicates if issuer onboarding was approved. | - |
issue_number * | integer | Issue number. | - |
issue_series * | integer | Issue series. | - |
contract_number * | string | Contract number. | - |
issue_date * | string | Issue date (ISO 8601 format). | - |
financial_base_date * | string | Operation financial base date (ISO 8601 format). | - |
commercial_paper_template_key * | string | Unique commercial paper template key. | 36 |
commercial_paper_document_key * | string | Commercial paper document key. | - |
adhesion_term_template_key * | string | Unique adhesion term template key. | 36 |
adhesion_term_document_key * | string | Adhesion term document key. | - |
investor_list * | object | Investor list. | investor object |
bank_account object
| Field | Type | Description | Max Characters |
|---|---|---|---|
account_type * | string | Account type (e.g. checking). | - |
account_digit * | string | Bank account digit. | - |
account_branch * | string | Bank branch. | - |
account_number * | string | Bank account number. | - |
financial_institution_ispb * | string | Financial institution ISPB code. | - |
financial_institution_code_number * | string | Financial institution code. | - |
financial object
| Field | Type | Description | Max Characters |
|---|---|---|---|
financial_base_date * | string | Operation financial base date (ISO 8601 format). | - |
issue_quantity * | integer | Total quantity of issued units. | - |
unit_price * | float | Issue unit price. | - |
issue_amount * | float | Total issue amount. | - |
released_amount * | float | Total released amount. | - |
cet * | float | Total Effective Cost of the operation (%). | - |
annual_cet * | float | Annualized Total Effective Cost (%). | - |
number_of_installments * | integer | Total number of operation installments. | - |
prefixed_interest_rate * | object | Prefixed interest rate. | prefixed_interest_rate object |
fine_delay_rate * | object | Delay fine rate | fine_delay_rate object. |
contract_fine_rate * | float | Contractual fine rate (%). | - |
financial_index | string | Financial reference index (if exists). | - |
post_fixed_interest_rate | object | Post-fixed interest rate (if applicable). | - |
fees * | array | List of applicable fees. | fees object |
installment_list * | array | Installment list. | installment object |
prefixed_interest_rate object
| Field | Type | Description | Max Characters |
|---|---|---|---|
daily_rate * | float | Daily interest rate (%). | - |
annual_rate * | float | Annualized interest rate (%). | - |
monthly_rate * | float | Monthly interest rate (%). | - |
interest_base * | string | Interest rate calculation base (calendar_days_365). | - |
fine_delay_rate object
| Field | Type | Description | Max Characters |
|---|---|---|---|
monthly_rate * | float | Monthly delay fine rate (%). | - |
interest_base * | string | Interest rate calculation base (calendar_days_365). | - |
fees object
| Field | Type | Description | Max Characters |
|---|---|---|---|
type * | string | Fee type (internal, external). | - |
amount * | float | Applied fee percentage. | - |
fee_type * | string | Fee type (implementation_fee). | - |
fee_amount * | float | Absolute value of applied fee. | - |
amount_type * | string | Value type (percentage, fixed). | - |
installment object
| Field | Type | Description | Max Characters |
|---|---|---|---|
installment_number * | integer | Installment number. | - |
workdays * | integer | Number of business days until maturity. | - |
calendar_days * | integer | Number of calendar days until maturity. | - |
principal_amortization_unit_price * | float | Principal amortization unit value. | - |
principal_amortization_amount * | float | Total principal amortization amount. | - |
interest_amount * | float | Total interest amount for the installment. | - |
amount * | float | Total installment amount. | - |
due_principal * | float | Principal amount due after the installment. | - |
due_interest * | float | Interest amount due after the installment. | - |
due_date * | string | Installment maturity date (ISO 8601 format). | - |
has_interest * | boolean | Indicates if the installment has interest charges. | - |
investor object
| Field | Type | Description | Max Characters |
|---|---|---|---|
investor_key * | string | Unique investor key (UUID v4). | 36 |
investor_name * | string | Investor name. | - |
investor_document_number * | string | Investor document number (CNPJ/CPF). | 18 |
subscription_percentage * | float | Investor participation percentage in the operation. | - |
subscription_quantity * | integer | Number of units subscribed by the investor. | - |
investor_onboarding_approved * | boolean | Indicates if investor onboarding was approved. | - |
bank_account * | object | Investor banking information. | bank_account object. |
operation_status enumerators
| Enum | Description |
|---|---|
in_filling | Operation in filling phase. |
in_analysis | Operation under analysis. |
waiting_onboarding_approval | Waiting for issuer onboarding approval. |
pending_signature_submission | Waiting to be sent for signature. |
waiting_signature | Waiting for signatures from involved parties. |
issued | Operation issued. |
finished | Operation completed. |
signature_rejected | Signature rejected. |
onboarding_reproved | Issuer onboarding rejected. |
compliance_reproved | Rejected by compliance. |
canceled | Operation canceled. |