Retrieving Public Quotas

Returns the approved and public quota values of the issuance series, by reference date. It is a public query: it requires neither an API key nor request signing.

Available on

Profile	Host	Required permission
Public	api.qidtvm.com.br	None (no API key required)

The public host serves production only. Base URL for each host: Environments (Hosts).

Request

ENDPOINT

/public_dash/mark_to_market/fund_quota/mark_to_markets

METHOD

GET

STATUS

200

Query Params

Parameter	Type	Description
internal_codes	list	List of internal codes of the issuance series (comma-separated or with the parameter repeated)
from_reference_date	string	Start date of the period to be queried (YYYY-MM-DD)
to_reference_date	string	End date of the period to be queried (YYYY-MM-DD)
internal_code	string	Unique code of the issuance series to be queried
fund_class_document_number	string	CNPJ (with punctuation) of the fund to be queried
limit	int	Items per page: from 1 to 400 (default 10)
page	int	Page, starting at 0 (default 0)

Only quota values with approved status and marked as public are returned.

Attention

The quota value is at the issuance series (issuance_serie) level, and therefore using the fund_class_document_number parameter returns all series. We recommend using this filter only to map the unique identifiers of the issuance series (internal_code and issuance_serie_key).

Response

Response Body

{
   "data": [
      {
         "issuance_serie_key": "1de4125b-48c7-40ca-b97b-0b65fb356468",
         "internal_code": "INTERNAL-CODE-2",
         "fund_class_document_number": "11.222.333/0001-81",
         "fund_class_name": "FUNDO DE INVESTIMENTO DE TESTES",
         "marks_to_market": [
            {
               "reference_date": "2025-09-05",
               "before_amortization_unit_price": 1000,
               "unit_price": 1000
            }
         ]
      },
      {
         "issuance_serie_key": "71f7ee44-388d-4916-b068-647e82fd67c8",
         "internal_code": "INTERNAL-CODE-1",
         "fund_class_document_number": "11.222.333/0001-81",
         "fund_class_name": "FUNDO DE INVESTIMENTO DE TESTES",
         "marks_to_market": [
            {
               "reference_date": "2025-09-04",
               "before_amortization_unit_price": 1000,
               "unit_price": 1000
            }
         ]
      }
   ],
   "limit": 5,
   "page": 0,
   "is_last_page": true
}

Issuance Serie

Field	Type	Description
issuance_serie_key	string	Key that identifies the issuance series
internal_code	string	Code that identifies the issuance series internally
fund_class_document_number	string	CNPJ of the queried investment fund
fund_class_name	string	Name of the queried investment fund
marks_to_market	array	List of Marks To Market objects

Marks To Market

Field	Type	Description
reference_date	string	Date of the issuance series quota value (YYYY-MM-DD)
before_amortization_unit_price	float	The issuance series quota value before an amortization
unit_price	float	The issuance series quota value after the closing

Errors

Status	Code	When it happens
400	—	limit outside the 1 to 400 range, negative page or date in an invalid format

Authentication, permission and host errors: see API Errors.