DataBolsa docs
Referência da APIPlataformaObjects

Histórico das observações de uma relação

Retorna uma linha por observação da relação, mais recente primeiro: em `snapshot`, uma por competência com a magnitude; em `event` (como `rates`), uma por decisão datada, com rótulo, perspectiva, ação e recorte de série. `static` não tem série. Observação ausente significa magnitude não publicada, não zero.

GET
/v1/objects/{id}/links/history
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
relstring

Relação snapshot cuja magnitude será lida competência a competência.

Value in"issued" | "distributes" | "tokenized_as" | "registered_as" | "assigned_to" | "owes_under" | "holds" | "manages" | "administers" | "custodies" | "audits" | "same_owner" | "shareholder_of" | "indexed_to" | "rates" | "mentions" | "measures" | "forecasts" | "contains" | "member_of" | "exposed_to_issuer" | "succeeded_by" | "produces" | "covers" | "coordinates" | "offers" | "exposed_to_sector" | "regulated_by" | "amends" | "revokes"
direction?string

Sentido da aresta a partir deste objeto: out = ele pratica o verbo; in = recebe.

Default"out"
Value in"out" | "in"
other_id?string

Prende o outro lado a um objeto específico.

source?string

Prende a afirmação a uma fonte específica.

from?string

Início do período (AAAA-MM-DD, inclusive).

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

Fim do período (AAAA-MM-DD, inclusive).

Match^\d{4}-\d{2}-\d{2}$
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/links/history?cursor=string&limit=100&rel=issued&direction=out&other_id=string&source=string&from=string&to=string&resolve=auto"
{
  "data": [
    {
      "rel": "string",
      "shape": "snapshot",
      "direction": "out",
      "other_id": "string",
      "other_kind": "string",
      "other_name": "string",
      "other_key_type": "string",
      "other_key": "string",
      "source": "string",
      "observed_at": "string",
      "magnitude": 0,
      "magnitude_unit": "string",
      "label": "string",
      "outlook": "string",
      "watch": "string",
      "action": "string",
      "series": "string",
      "confidence": "high"
    }
  ],
  "meta": {
    "next_cursor": "string",
    "count": 0,
    "total": 0,
    "subject": {
      "property1": "string",
      "property2": "string"
    }
  }
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "details": {
    "property1": null,
    "property2": null
  }
}