Recuperando Informações sobre as Ofertas

---

Lista as ofertas de cotas de uma classe de fundo, de forma paginada.

Disponível em

Perfil	Host	Permissão exigida
Gestora	manager-api	Leitura

URL base de cada host: Ambientes (Hosts).

Request

ENDPOINT

/quota_offering_control/fund_class/FUND_CLASS_KEY/quota_offerings

MÉTODO

GET

STATUS

200

Query Params

Parâmetro	Descrição
limit	Itens por página. Padrão 50, máximo 500
page	Página, começando em 0. Padrão 0
sub_class_key	Chave única de identificação da sub classe
issuance_serie_key	Chave única de identificação da série de emissão
showOffers	active: só ofertas ativas com valor restante. closed: ofertas fechadas ou com vencimento no passado

Responses

Caso 01: Fundo com uma Oferta

{
   "data":[
      {
         "quota_offering_key":"UUID",
         "status":"active",
         "original_quota_offering_value":0.00,
         "issued_number_of_quotas":0.00000000,
         "remaining_quota_offering_value":0.00,
         "start_date":"YYYY-MM-DD",
         "issuance_serie":{
            "name":"1",
            "issuance_serie_key":"UUID",
            "sub_class":{
               "name":"SÊNIOR",
               "sub_class_key":"UUID",
               "subordination_level":1,
               "fund_class":{
                  "fund_class_key":"UUID",
                  "name":"SAMPLE FUND CLASS NAME",
                  "document_number":"00.000.000/0000-00",
                  "short_name":"SAMPLE FUND CLASS SHORT NAME"
               }
            },
            "classification":"general / qualified / professional",
            "market_type":"primary / secondary"
         },
         "type":"public / private",
         "subscription_note_template_key":"UUID",
         "subscription_note_generation_type":"internal / external",
         "regulatory_type":"exclusive_fund",
         "cvm_registration":{
            "date":"YYYY-MM-DD",
            "number":"AAA/BBB/CCC/DDD/EEE/YYYY/000"
         },
         "lead_coordinator":{
            "name":"SAMPLE LEAD COORDINATOR NAME",
            "address":{
               "uf":"SP",
               "city":"São Paulo",
               "number":"0000",
               "street":"Sample street name",
               "complement":"Sample complement"
            },
            "document_number":"00.000.000/0000-00"
         },
         "status_events":[
            {
               "status":"active",
               "event_datetime":"YYYY-MM-DD HH:MM:SS"
            }
         ]
      }
   ],
   "limit":50,
   "page":0,
   "is_last_page":true
}

Caso 02: Fundo sem uma Oferta

{
   "data":[],
   "limit":50,
   "page":0,
   "is_last_page":true
}

Response Fields

Campo	Tipo	Descrição
data	array	Lista de objetos de Quota Offering
limit	int	Limite de objetos recuperados por página
page	int	Número da página recuperada
is_last_page	boolean	Informação que indica se a página recuperada é a última

Quota Offering

Campo	Tipo	Descrição
quota_offering_key	string	Chave única de identificação da oferta
status	string	created / active / processing_closing / pending_closing_at_cvm / pending_closing_at_anbima / pending_divulgation / closed
subscription_note_generation_type	string	internal (documento gerado pela QI) / external
subscription_note_template_key	string	Chave do modelo do boletim de subscrição
regulatory_type	string	Tipo regulatório da oferta
status_events	array	Histórico de status (status, event_datetime)
original_quota_offering_value	float	Valor original da oferta
issued_number_of_quotas	float	Quantidade de cotas subscritas
remaining_quota_offering_value	float	Valor restante da oferta
start_date	string	Data inicial da oferta
issuance_serie	string	Objeto de Issuance Serie
type	string	Tipo da oferta pública/privada
cvm_registration	JSON	Dados do registro CVM. Ausente quando não preenchido
lead_coordinator	JSON	Dados do coordenador líder. Ausente quando não preenchido
maturity_date	string	Data de vencimento. Ausente quando não preenchida
original_number_of_quotas	float	Quantidade original de cotas. Ausente quando não preenchida

cvm_registration

{
   "date":"YYYY-MM-DD",
   "number":"AAA/BBB/CCC/DDD/EEE/YYYY/000"
}

lead_coordinator

{
   "name":"SAMPLE LEAD COORDINATOR NAME",
   "address":{
      "uf":"SP",
      "city":"São Paulo",
      "number":"0000",
      "street":"Sample street name",
      "complement":"Sample complement"
   },
   "document_number":"00.000.000/0000-00"
}

Issuance Serie

Campo	Tipo	Descrição
name	string	Nome da série de emissão
issuance_serie_key	string	Chave única de identificação da série de emissão
sub_class	JSON	Objeto de Sub Class
classification	string	Profissional / Qualificado / Geral
market_type	string	Primário / Secundário
serie	integer	Número sequencial da série de emissão dentro da sub classe (1, 2, 3...). Não se repete na mesma sub classe

Sub Class

Campo	Tipo	Descrição
name	string	Nome da sub classe
sub_class_key	string	Chave única de identificação da sub classe
subordination_level	int	Nível de subordinação da sub classe
fund_class	JSON	Objeto de Fund Class

Fund Class

Campo	Tipo	Descrição
name	string	Nome da classe de fundo
fund_class_key	string	Chave única de identificação da classe de fundo
document_number	string	CNPJ da classe de fundo
short_name	string	Nome reduzido da classe de fundo

Erros

Status	Código	Quando acontece
400	QIT000004	A classe de fundo não é gerida pela gestora
404	QOF000007	Classe de fundo não encontrada

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