DataBolsa docs
Referência da APIPlataformaObjects

Lista trechos de documentos que sustentam o objeto

Retorna trechos de documentos associados ao objeto, com protocolo, fonte e páginas. `excerpt` preserva o texto do documento. A associação prova que o documento pertence ao objeto; não prova, sozinha, uma relação ou medida específica. Para relações, consulte `source` na própria aresta. Os resultados seguem a ordem de entrada no acervo, do mais recente para o mais antigo, e podem ser recortados por `from`/`to`. Resposta vazia significa que não há evidência indexada para o recorte, não que a afirmação investigada seja falsa.

GET
/v1/objects/{id}/evidence
AuthorizationBearer <token>

In: header

Path Parameters

idstring

Identificador canônico do objeto (pub_…). Operações em lote aceitam vários ids separados por vírgula.

Query Parameters

cursor?string

Cursor opaco de meta.next_cursor da página anterior; omita na primeira página.

limit?integer

Itens por página (1–1000, default 100).

Default100
Range1 <= value <= 1000
from?string

Data de referência mínima do documento.

Match^\d{4}-\d{2}-\d{2}$
to?string

Data de referência máxima do documento.

Match^\d{4}-\d{2}-\d{2}$
category?string

Recorte pelo tipo do documento, por trecho do nome e sem diferenciar caixa (regulamento, fato relevante, termo de securitiza).

heading?string

Recorte pela seção do documento, por trecho do título (garantias, cascata). Documentos sem estrutura reconhecida não têm seção e respondem vazio.

resolve?string

Como interpretar o id: auto segue fusões e, em cisões, responde 409 com os sucessores; exact lê literalmente o objeto desse id. Use exact para acessar o ramo de uma cisão que preservou o identificador original ou para desativar o redirecionamento automático.

Default"auto"
Value in"auto" | "exact"

Response Body

curl -X GET "https://api.databolsa.com/v1/objects/string/evidence?cursor=string&limit=100&from=string&to=string&category=string&heading=string&resolve=auto"
{
  "data": [
    {
      "protocol": "string",
      "source": "string",
      "url": "string",
      "category": "string",
      "type": "string",
      "reference_date": "string",
      "filed_at": "string",
      "page_start": 0,
      "page_end": 0,
      "heading": "string",
      "excerpt": "string"
    }
  ],
  "meta": {
    "next_cursor": "string",
    "count": 0,
    "total": 0,
    "subject": {
      "property1": "string",
      "property2": "string"
    },
    "uncovered_reason": "string"
  }
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "details": {
    "property1": null,
    "property2": null
  }
}

Lista eventos associados a um objeto

Retorna eventos do emissor associados por todos os seus tickers, sem duplicar um evento marcado com mais de um papel. A cobertura depende principalmente de ticker; lista vazia para objeto sem ticker não prova ausência de eventos. Use `listMarketEvents` para o ledger inteiro e `listCorporateEvents` para eventos societários. Duas fontes na mesma página, separadas por `type`. `market_event` é o ledger editorial — o único com `score`, detectores, thread e fontes. `renamed` é a TROCA DE CÓDIGO de negociação do papel, com o código anterior e o novo em `details`: ela não é uma ligação porque as duas pontas são o mesmo objeto, então `listObjectLinks(rel=succeeded_by)` responde só as incorporações e a renomeação sai aqui.

Obtém as medidas mais recentes de um ou vários objetos

Retorna as medidas mais recentes de até 50 objetos; `facts` pode selecionar até 10 medidas. Cada linha traz `entity_id`, e `meta.subjects` informa ids inexistentes, divididos ou sem dados sem reduzir o lote em silêncio. Confira `unit`, escala e `as_of` de cada medida: frequências e datas-base podem diferir na mesma resposta. `series` identifica o recorte da medida — a classe do papel, ou o escopo contábil da demonstração (`consolidado` por default, `individual` quando pedido em `series`). Para a série temporal, use `getObjectHistory`. Com `at`, medidas com `availability=filed` respeitam data-base e publicação; quando `availability=unknown`, o corte considera apenas a data-base e não constitui um point-in-time completo.