Pular para o conteúdo principal

Listagem de Solicitações de Amortização

Endpoint de consulta paginada que retorna as solicitações de amortização de uma determinada classe de fundo. A resposta inclui, para cada solicitação, os dados financeiros calculados, o histórico de status, as amortizações por investidor e os dados da série de emissão vinculada.

Filtros de retorno

Por padrão, todos os sub-objetos (issuance_serie, investor_amortizations e status_events) são retornados. Utilize os query params dto_filters_* para omitir campos e reduzir o tamanho da resposta.

Request​

ENDPOINT
/quota/fund_class/{fund_class_key}/amortization_requests
MÉTODO
GET

Path params​

ParâmetroTipoDescrição
fund_class_keystringChave única da classe de fundo (UUID).

Query params​

ParâmetroTipoObrigatoriedadeDescrição
pageintegeropcionalNúmero da página (começa em 0). Padrão: 0.
limitintegeropcionalQuantidade de registros por página. Padrão: 20. Máximo: 100.
dto_filters_issuance_seriebooleanopcionalQuando true, omite o objeto issuance_serie de cada item. Padrão: false.
dto_filters_investor_amortizationsbooleanopcionalQuando true, omite o array investor_amortizations de cada item. Padrão: false.
dto_filters_status_eventsbooleanopcionalQuando true, omite o array status_events de cada item. Padrão: false.
Exemplo de chamada
GET /quota/fund_class/{fund_class_key}/amortization_requests?page=0&limit=20

Response​

STATUS
200
Response Body
{
  "data": [
    {
      "amortization_request_key": "3571e292-3a83-4011-904d-20ee963022ef",
      "type": "scheduled_amortization",
      "regime_type": "issuance_serie_principal_percentage",
      "quotation_date": "2026-06-05",
      "principal_percentage": 0.5,
      "financial_application_yield_percentage": 0.12,
      "gross_value": 10000.0,
      "result_quota_value": 1.05,
      "amortization_value": 5000.0,
      "net_value": 4750.0,
      "quota_percentage": 0.5,
      "status": "done",
      "status_events": [
        {
          "status": "created",
          "event_datetime": "2026-06-01T10:00:00.000Z"
        },
        {
          "status": "done",
          "event_datetime": "2026-06-05T14:30:00.000Z"
        }
      ],
      "investor_amortizations": [
        {
          "investor_amortization_key": "f1e2d3c4-b5a6-7890-fedc-ba9876543210",
          "investor": {
            "investor_key": "aaaa1111-bbbb-2222-cccc-dddd33334444",
            "name": "Investidor Exemplo S.A.",
            "person_type": "legal",
            "document_number": "12.345.678/0001-99",
            "distributor": {
              "distributor_key": "dddd4444-eeee-5555-ffff-aaaa66667777",
              "name": "Distribuidora Exemplo",
              "document_number": "98.765.432/0001-11",
              "account_data": {
                "bank": "341",
                "agency": "1234",
                "account": "56789-0"
              }
            }
          },
          "status": "done",
          "net_value": 4750.0,
          "ir_value": 200.0,
          "iof_value": 50.0,
          "ir_compensation": 0.0,
          "iof_compensation": 0.0,
          "total_value": 5000.0,
          "payment_method": "regular",
          "payment_date": "2026-06-06",
          "status_events": [
            {
              "status": "created",
              "event_datetime": "2026-06-01T10:00:00.000Z"
            },
            {
              "status": "done",
              "event_datetime": "2026-06-06T09:00:00.000Z"
            }
          ],
          "amortizations": [
            {
              "financial_application_key": "fa111111-2222-3333-4444-555566667777",
              "amortization_key": "am888888-9999-aaaa-bbbb-ccccddddeeee",
              "status": "settled",
              "principal_reduction": 2500.0,
              "acquisition_cost_reduction": 0.0,
              "yield_value": 300.0,
              "total_value": 2800.0,
              "ir_value": 100.0,
              "iof_value": 25.0,
              "taxable_yield_value": 300.0
            }
          ],
          "payments": [
            {
              "payment_key": "pp000000-1111-2222-3333-444455556666",
              "origin_key": "f1e2d3c4-b5a6-7890-fedc-ba9876543210",
              "total_value": 4750.0,
              "target_account": {
                "bank": "341",
                "agency": "1234",
                "account": "56789-0"
              },
              "payment_type": "amortization_payment.investor",
              "payment_date": "2026-06-06",
              "status": "paid",
              "status_events": [
                {
                  "status": "paid",
                  "event_datetime": "2026-06-06T09:15:00.000Z"
                }
              ]
            }
          ]
        }
      ],
      "issuance_serie": {
        "issuance_serie_key": "is111111-2222-3333-4444-555566667777",
        "name": "Série A - Cota Sênior",
        "serie": 1,
        "original_quota_value": 1.0,
        "current_quota_value": 1.05,
        "current_number_of_quotas": 1000000.0,
        "current_net_worth": 1050000.0,
        "current_principal_value": 1000000.0,
        "performance_fee_current_value": 0.0,
        "remuneration_type": "cdi_plus",
        "minimum_share_capital": 1000.0,
        "status": "active",
        "internal_code": "SR-001",
        "processing_method": "pro_rata",
        "operation_period_configuration": {
          "subscription_days": [1, 2, 3, 4, 5],
          "redemption_days": [1, 2, 3, 4, 5]
        },
        "sub_class": {
          "sub_class_key": "sc222222-3333-4444-5555-666677778888",
          "name": "Classe Sênior",
          "subordination_level": 1,
          "fund_class": {
            "fund_class_key": "fc333333-4444-5555-6666-777788889999",
            "name": "Fundo de Investimento em Direitos Creditórios Exemplo",
            "short_name": "FIDC Exemplo",
            "document_number": "11.222.333/0001-44",
            "accounting_date": "2026-06-09",
            "sub_type": "exclusive",
            "tax_classification": "long_term",
            "condominum_type": "closed",
            "investment_category": "credit_rights",
            "prevent_payment": false,
            "manager": {
              "manager_key": "mg444444-5555-6666-7777-888899990000",
              "name": "Gestora Exemplo DTVM",
              "document_number": "55.666.777/0001-88"
            }
          }
        }
      }
    }
  ],
  "limit": 20,
  "page": 0,
  "is_last_page": true
}

Atributos da resposta​

CampoTipoDescrição
dataarrayLista de solicitações de amortização. Veja tabela abaixo.
pageintegerNúmero da página atual.
limitintegerQuantidade de registros por página.
is_last_pagebooleanIndica se esta é a última página de resultados.

Atributos de cada solicitação (objetos dentro de data)​

CampoTipoDescrição
amortization_request_keystringIdentificador único da solicitação (UUID).
typestringTipo da amortização. Consulte os enumeradores de tipo abaixo.
regime_typestringRegime de cálculo da amortização. Consulte os enumeradores de regime abaixo.
quotation_datestringData de cotação no formato YYYY-MM-DD.
principal_percentagenumberPercentual do principal a ser amortizado. Presente conforme o regime_type.
financial_application_yield_percentagenumberPercentual de rendimento da aplicação financeira. Presente conforme o regime_type.
gross_valuenumberValor bruto total da amortização em reais.
result_quota_valuenumberValor da cota resultante após a amortização.
amortization_valuenumberValor total a ser amortizado em reais.
net_valuenumberValor líquido total após impostos em reais.
quota_percentagenumberPercentual de cotas resgatadas. Presente conforme o regime_type.
statusstringStatus atual da solicitação. Consulte os enumeradores de status abaixo.
status_eventsarrayHistórico de transições de status. Omitido se dto_filters_status_events=true. Veja tabela abaixo.
investor_amortizationsarrayLista de amortizações individuais por investidor. Omitido se dto_filters_investor_amortizations=true. Veja tabela abaixo.
issuance_serieobjectDados da série de emissão vinculada. Omitido se dto_filters_issuance_serie=true. Veja tabela abaixo.

Atributos de status_events​

CampoTipoDescrição
statusstringStatus do evento.
event_datetimestringData e hora do evento no formato ISO 8601 (ex: 2026-06-01T10:00:00.000Z).

Atributos de investor_amortizations​

CampoTipoDescrição
investor_amortization_keystringIdentificador único da amortização do investidor (UUID).
investorobjectDados do investidor. Veja tabela abaixo.
statusstringStatus da amortização do investidor. Consulte os enumeradores de status do investidor abaixo.
net_valuenumberValor líquido a pagar ao investidor em reais.
ir_valuenumberValor de IR retido em reais.
iof_valuenumberValor de IOF retido em reais.
ir_compensationnumberCompensação de IR em reais.
iof_compensationnumberCompensação de IOF em reais.
total_valuenumberValor total bruto em reais. Presente após o cálculo.
payment_methodstringMétodo de pagamento. Consulte os enumeradores de método de pagamento abaixo.
payment_datestringData prevista do pagamento no formato YYYY-MM-DD.
status_eventsarrayHistórico de transições de status do investidor. Mesma estrutura de status_events da solicitação.
amortizationsarrayDetalhamento por aplicação financeira. Veja tabela abaixo.
paymentsarrayLista de pagamentos gerados. Veja tabela abaixo.

Atributos de investor​

CampoTipoDescrição
investor_keystringChave única do investidor (UUID).
namestringNome do investidor.
person_typestringTipo de pessoa (natural ou legal).
document_numberstringCPF ou CNPJ do investidor. Presente quando disponível.
external_idstringIdentificador externo do investidor. Presente quando informado.
external_distribution_keystringChave de distribuição externa. Presente quando informada.
short_namestringNome abreviado. Presente quando informado.
sub_typestringSubtipo do investidor. Presente quando informado.
distributorobjectDados da distribuidora vinculada. Veja tabela abaixo.

Atributos de distributor​

CampoTipoDescrição
distributor_keystringChave única da distribuidora (UUID).
namestringNome da distribuidora.
document_numberstringCNPJ da distribuidora.
account_dataobjectDados bancários da distribuidora.

Atributos de amortizations​

CampoTipoDescrição
financial_application_keystringChave da aplicação financeira (UUID).
amortization_keystringChave única da amortização (UUID).
statusstringStatus da amortização.
principal_reductionnumberRedução de principal em reais.
acquisition_cost_reductionnumberRedução de custo de aquisição em reais.
yield_valuenumberValor de rendimento em reais. Presente quando calculado.
total_valuenumberValor total em reais. Presente quando calculado.
ir_valuenumberValor de IR em reais. Presente quando calculado.
iof_valuenumberValor de IOF em reais. Presente quando calculado.
taxable_yield_valuenumberValor de rendimento tributável em reais. Presente quando calculado.

Atributos de payments​

CampoTipoDescrição
payment_keystringChave única do pagamento (UUID).
origin_keystringChave da origem do pagamento (UUID).
total_valuenumberValor total do pagamento em reais.
target_accountobjectDados da conta de destino.
descriptionstringDescrição do pagamento. Presente quando informada.
payment_typestringTipo do pagamento. Consulte os enumeradores de tipo de pagamento abaixo.
payment_datestringData do pagamento no formato YYYY-MM-DD.
statusstringStatus do pagamento. Consulte os enumeradores de status do pagamento abaixo.
deleted_atstringData e hora de exclusão no formato ISO 8601. Presente apenas quando o pagamento foi cancelado.
status_eventsarrayHistórico de transições de status do pagamento. Mesma estrutura de status_events da solicitação.

Atributos de issuance_serie​

CampoTipoDescrição
issuance_serie_keystringChave única da série de emissão (UUID).
namestringNome da série de emissão.
serieintegerNúmero da série.
original_quota_valuenumberValor original da cota em reais.
current_quota_valuenumberValor atual da cota em reais (calculado como current_net_worth / current_number_of_quotas).
current_number_of_quotasnumberQuantidade atual de cotas em circulação.
current_net_worthnumberPatrimônio líquido atual em reais.
current_principal_valuenumberValor de principal atual em reais.
performance_fee_current_valuenumberValor atual de taxa de performance em reais.
remuneration_typestringTipo de remuneração da série.
minimum_share_capitalnumberCapital mínimo em reais.
statusstringStatus da série de emissão.
internal_codestringCódigo interno da série.
processing_methodstringMétodo de processamento (ex: pro_rata).
operation_period_configurationobjectConfiguração de períodos operacionais da série.
pre_fixednumberTaxa pré-fixada. Presente quando aplicável.
post_fixedobjectDados do indexador pós-fixado. Presente quando aplicável.
interest_rate_typestringTipo de taxa de juros. Presente quando aplicável.
isin_codestringCódigo ISIN da série. Presente quando informado.
external_idstringIdentificador externo. Presente quando informado.
specific_interest_rate_dataobjectDados específicos de taxa de juros. Presente quando aplicável.
fixed_principal_valuenumberValor de principal fixo. Presente quando aplicável.
sub_classobjectDados da subclasse vinculada. Veja tabela abaixo.

Atributos de sub_class​

CampoTipoDescrição
sub_class_keystringChave única da subclasse (UUID).
namestringNome da subclasse.
subordination_levelintegerNível de subordinação da subclasse.
fund_classobjectDados da classe de fundo. Veja tabela abaixo.

Atributos de fund_class​

CampoTipoDescrição
fund_class_keystringChave única da classe de fundo (UUID).
namestringNome do fundo.
short_namestringNome abreviado do fundo.
document_numberstringCNPJ do fundo.
accounting_datestringData contábil vigente no formato YYYY-MM-DD.
sub_typestringSubtipo do fundo.
tax_classificationstringClassificação tributária do fundo.
condominum_typestringTipo de condomínio do fundo.
investment_categorystringCategoria de investimento.
prevent_paymentbooleanIndica se pagamentos estão bloqueados para o fundo.
managerobjectDados do gestor do fundo.
administratorobjectDados do administrador. Presente quando informado.
integralization_account_keystringChave da conta de integralização (UUID). Presente quando informada.

Enumeradores de type​

ValorDescrição
scheduled_amortizationAmortização programada/agendada
extraordinary_amortizationAmortização extraordinária

Enumeradores de regime_type​

ValorDescrição
cash_availabilityBaseado na disponibilidade de caixa
issuance_serie_principal_percentagePercentual do principal da série de emissão
quota_percentagePercentual de cotas
financial_application_principal_percentagePercentual do principal da aplicação financeira
net_valueValor líquido fixo
gross_valueValor bruto fixo
financial_application_yield_percentagePercentual de rendimento da aplicação financeira

Enumeradores de status​

StatusDescrição
createdSolicitação criada
waiting_quotation_dateAguardando data de cotação
pending_inputsAguardando dados de entrada
processing_calculationCálculo em processamento
processing_investor_amortizationsProcessando amortizações dos investidores
pending_manual_approvalAguardando aprovação manual
processing_approvalAprovação em processamento
processing_issuance_serie_impactsProcessando impactos na série de emissão
reprocessedReprocessada
reprovedReprovada
doneConcluída

Enumeradores de status do investor_amortization​

StatusDescrição
createdAmortização do investidor criada
pending_quoteAguardando cotação
processing_approvalAprovação em processamento
pending_manual_approvalAguardando aprovação manual
doneConcluída
reprovedReprovada

Enumeradores de payment_method​

ValorDescrição
regularPagamento padrão (TED/PIX)
b3Pagamento via B3

Enumeradores de payment_type​

ValorDescrição
amortization_payment.investorPagamento de amortização ao investidor
amortization_payment.irRecolhimento de IR da amortização
amortization_payment.iofRecolhimento de IOF da amortização
amortization_payment.collateralPagamento de garantia da amortização
redemption.investorPagamento de resgate ao investidor
redemption.irRecolhimento de IR do resgate
redemption.iofRecolhimento de IOF do resgate
redemption.integralization_iofRecolhimento de IOF de integralização do resgate
redemption.tax_anticipationAntecipação de tributos do resgate

Enumeradores de status do payment​

StatusDescrição
createdPagamento criado
pending_paymentAguardando pagamento
pending_manual_approvalAguardando aprovação manual
pending_confirmationAguardando confirmação
pending_accounting_dateAguardando data contábil
paidPago
canceledCancelado