Skip to main content

Portfolio - Portfolio Recovery

Portfolio List​

Request​

ENDPOINT
/composition/fund_class/FUND_CLASS_KEY/compositions
METHOD
GET

Query Params​

ParameterDescription
not_statusFilters results excluding compositions that are in the informed status.
statusFilters results bringing only compositions that are in the informed status.
reference_dateReference date for querying compositions. Must be in YYYY-MM-DD format.
typeType of composition to be filtered pre_quota/final_quota.
start_dateStart date of the search range. Required if end_date is informed. Format: YYYY-MM-DD.
end_dateEnd date of the search range. Required if start_date is informed. Format: YYYY-MM-DD.
Warning

There are two ways to filter by date:

  • Consuming a specific date, sending the reference_date field as query param.
  • Consuming a period, sending the start_date and end_date fields as query param
Response Body
{
    "data": [
        {
            "composition_key": "f2208257-1489-4937-8862-031bca34016f",
            "status": "confirmed",
            "type": "pre_quota",
            "composition_date": "2024-11-13",
            "fund_class": {
                "name": "A SAMPLE CLASS",
                "fund_class_key": "5dac941c-c779-4049-a4ee-7cee583b6860",
                "document_number": "18.687.469/0001-06"
            }
        },
        {
            "composition_key": "f2208257-1489-4937-8862-031bca34016f",
            "status": "confirmed",
            "type": "final_quota",
            "composition_date": "2024-11-13",
            "fund_class": {
                "name": "A SAMPLE CLASS",
                "fund_class_key": "5dac941c-c779-4049-a4ee-7cee583b6860",
                "document_number": "18.687.469/0001-06"
            }
        }
    ],
    "limit": 50,
    "page": 0,
    "is_last_page": true
}

Paginated Object​

FieldTypeDescription
dataarrayList of Composition objects
limitintLimit of objects retrieved per page
pageintNumber of the retrieved page
is_last_pagebooleanInformation indicating if the retrieved page is the last

Composition​

FieldTypeDescription
composition_keystringUnique portfolio identification key
statusstringThe status of that portfolio
typestringThe type of that portfolio, pre_quota/final_quota
composition_datestringReference date of the portfolio
fund_classobjectFund Class object

Fund Class​

FieldTypeDescriptionCharacters
namestringFund class nameup to 255
fund_class_keystringUnique fund class identification key36
document_numberstringFund class CNPJ-

Portfolio Information​

Request​

ENDPOINT
/composition/fund_class/FUND_CLASS_KEY/composition/COMPOSITION_KEY
METHOD
GET
Response Body
{
    "composition_key": "f2208257-1489-4937-8862-031bca34016f",
    "status": "confirmed",
    "type": "pre_quota",
    "composition_date": "2024-12-02",
    "fund_class": {
        "name": "A SAMPLE CLASS",
        "fund_class_key": "5dac941c-c779-4049-a4ee-7cee583b6860",
        "document_number": "18.687.469/0001-06"
    },
    "issuance_series": [
      {
        "issuance_serie_key": "840e01e9-0df8-4719-83c4-f10b839d8384",
        "name": "SUBORDINADA - 1",
        "gross_net_worth": 1891397.29,
        "net_net_worth": 1891397.29,
        "gross_quota_value": 1.76821576,
        "net_quota_value": 1.76821576,
        "number_of_quotas": 1069664.309518427,
        "applied_value": 0.0,
        "applied_quotas": 0.0,
        "redeemed_value": 0.0,
        "redeemed_quotas": 0.0,
        "amortized_value": 0.0,
        "tax_anticipated_value": 0.0,
        "tax_anticipated_quotas": 0.0,
        "profitabilities": [
            {
                "reference_date": "2024-11-29", 
                "quota_value": 1.76065188,
                "di_benchmark_quota_value": 1.7613906
            },
            {
                "reference_date": "2024-11-25", 
                "quota_value": 1.7568068,
                "di_benchmark_quota_value": 1.76049545
            },
            {
                "reference_date": "2024-11-01", 
                "quota_value": 1.74121452,
                "di_benchmark_quota_value": 1.75502225
            },
            {
                "reference_date": "2024-10-03", 
                "quota_value": 1.72167143,
                "di_benchmark_quota_value": 1.75002091
            },
            {
                "reference_date": "2024-09-03", 
                "quota_value": 1.70128747,
                "di_benchmark_quota_value": 1.74445962
            },
            {
                "reference_date": "2024-06-05", 
                "quota_value": 1.63380383,
                "di_benchmark_quota_value": 1.7178922
            },
            {
                "reference_date": "2023-12-08", 
                "quota_value": 1.52421994,
                "di_benchmark_quota_value": 1.68553599
            }
        ]
      }
    ],
    "assets": [
        {
            "asset_key": "34f42521-f27f-424a-958f-8b53f15cc80d",
            "asset_type": "fixed_income_fund_quota",
            "purchase_date": "2024-11-27",
            "total_purchase_value": 1009320,
            "bad_debt_percentage": 0,
            "bad_debt_value": 0,
            "overdue_accounting_value": 0,
            "current_accounting_value": 1234335,
            "current_fair_accounting_value": 1234335
        }
    ],
    "consolidated_assets": [
        {
            "asset_type": "ccb",
            "total_units": 175623,
            "bad_debt_value": 0,
            "overdue_accounting_value": 75642,
            "current_accounting_value": 187762590,
            "current_fair_accounting_value": 187762590
        }
    ],
    "receivables": [
        {
          "origin_key": "a60f9226-edac-488e-9a58-6205a334e6ba",
          "origin_type": "expense",
          "description": "Taxa CVM - 2024",
          "total_value": 711515,
          "recognized_value": 654125,
          "start_date": "2024-01-09",
          "end_date": "2024-12-31",
          "payment_date": "2024-05-10"
        }
    ],
    "payables": [
      {
        "origin_key": "19b83b17-d36c-4edd-97fe-99af6a0a4a63",
        "origin_type": "expense",
        "description": "Taxa de Gestão - 2024/12",
        "total_value": 14586,
        "recognized_value": 14586,
        "start_date": "2024-12-02",
        "end_date": "2024-12-31",
        "payment_date": "2025-01-08"
      },
    ],
    "cash_accounts": [
      {
        "account_key": "a41e4fa8-6950-485e-9a5b-70f21cc6774a",
        "balance": 100000,
        "unconcilied_cash_in": 0,
        "unconcilied_cash_out": 0,
        "account_branch": "0001",
        "account_digit": "1",
        "account_number": "372832",
        "accounting_identification": 1,
        "financial_institution": {
            "code": "329",
            "ispb": "32402502",
            "name": "QI Sociedade de Crédito Direto"
        }
      }
    ]
}

Complete Composition​

FieldTypeDescription
composition_keystringUnique portfolio identification key
statusstringThe status of that portfolio
typestringThe type of that portfolio, pre_quota/final_quota
composition_datestringReference date of the portfolio
fund_classobjectFund Class object
issuance_seriesarrayList of Issuance Series objects
assetsarrayList of Assets objects
consolidated_assetsarrayList of Consolidated Assets objects
receivablesarrayList of Receivables objects
payablesarrayList of Paybles objects
cash_accountsarrayList of Cash Accounts objects

Issuance Serie​

FieldTypeDescription
issuance_serie_keystringUnique issuance series identification key
namestringThe name of that series
gross_net_worthfloatGross net worth of that series
net_net_worthfloatNet worth of that series
gross_quota_valuefloatGross quota value
net_quota_valuefloatNet quota value
number_of_quotasfloatTotal number of quotas
profitabilitiesarrayList of Profitability objects

Profitability​

FieldTypeDescription
reference_datestringReference date on which performance is analyzed
quota_valuefloatSeries quota value on the reference date
di_benchmark_quota_valuefloatQuota value today if the reference quota ran at 100% DI

Assets​

FieldTypeDescription
asset_keystringUnique asset identification key
asset_typestringAsset type
purchase_datestringAsset acquisition date
total_purchase_valuestringTotal asset acquisition value
bad_debt_percentagestringApplied PDD percentage
bad_debt_valueintegerTotal PDD value considered - Integer in cents
overdue_accounting_valueintegerAsset overdue value - Integer in cents
current_accounting_valueintegerAsset total value - Integer in cents
current_fair_accounting_valueintegerAsset total value - Integer in cents

Consolidated Assets​

FieldTypeDescription
asset_typestringAsset type
total_unitsstringTotal number of consolidated assets of this type
bad_debt_valueintegerTotal PDD value considered - Integer in cents
overdue_accounting_valueintegerAsset overdue value - Integer in cents
current_accounting_valueintegerAsset total value - Integer in cents
current_fair_accounting_valueintegerReference date on which performance is analyzed

Receivables​

FieldTypeDescription
origin_keystringUnique identification key of the resource that originates this receivable
origin_typestringType of resource that originates this receivable
descriptionstringItem description
total_valuefloatTotal receivable value
recognized_valuefloatValue that has already been allocated
start_datestringAllocation start date
end_datestringAllocation end date
payment_datestringSettlement date

Payables​

FieldTypeDescription
origin_keystringUnique identification key of the resource that originates this payable
origin_typestringType of resource that originates this payable
descriptionstringItem description
total_valuefloatTotal payable value
recognized_valuefloatValue that has already been allocated
start_datestringAllocation start date
end_datestringAllocation end date
payment_datestringSettlement date

Cash Accounts​

FieldTypeDescription
account_keystringUnique account identification key
balanceintegerAccount balance - Integer in cents
unconcilied_cash_inintegerValue of inflows to reconcile in this account - Integer in cents
unconcilied_cash_outintegerValue of outflows to reconcile in this account - Integer in cents
account_branchstringAccount branch
account_digitstringAccount digit
account_numberstringAccount number
accounting_identificationintegerAccounting identifier of that account
financial_institutionobjectFinancial Institution object

Financial Institution​

FieldTypeDescription
codestringFinancial institution COMPE code
ispbstringFinancial institution ISPB
namestringFinancial institution name