List shares history

GET https://data.partnr.ai/v2/companies/[companyIdentifier]/shares-history

Return a list of shares history from the company specified by the [companyIdentifier].

Request Parameters

Parameter	Location	Description	Required
[companyIdentifier]	URL	Company Identifier of the company to be queried.	Required
start_date	Query parameter	Date to start time-series. Format: YYYY-MM-DD	Optional
end_date	Query parameter	Date to end time-series. Format: YYYY-MM-DD	Optional

Company Identifier

The [companyIdentifier] can be one of the following:

• symbol: the company's symbol. Example: PETR (Petrobras' Symbol)
• company_id: the company's ID (CNPJ). Example: 33000167000101 (Petrobras' CNPJ)
• ticker: the company's ticker. Example: PETR3 (Petrobras' Ticker for common stock)

Response

Code	Description
200	Returns a list of shares history.
400	Missing or malformed required parameters.
404	The company was not found.
401	Unauthorized.

Example

[
  {
    "date": "2022-08-17T00:00:00.000Z",
    "common_shares": 246359319,
    "preferred_shares": 0
  },
  {
    "date": "2020-07-24T00:00:00.000Z",
    "common_shares": 256720235,
    "preferred_shares": 0
  },
  {
    "date": "2015-04-23T00:00:00.000Z",
    "common_shares": 153909975,
    "preferred_shares": 12810260
  },
  {
    "date": "2014-04-16T00:00:00.000Z",
    "common_shares": 153909975,
    "preferred_shares": 12810260
  },
  {
    "date": "2013-10-16T00:00:00.000Z",
    "common_shares": 153909975,
    "preferred_shares": 12810260
  },
  {
    "date": "2012-04-19T00:00:00.000Z",
    "common_shares": 149279740,
    "preferred_shares": 12810260
  },
  {
    "date": "2007-02-13T00:00:00.000Z",
    "common_shares": 7463987,
    "preferred_shares": 640513
  },
  {
    "date": "1941-06-06T00:00:00.000Z",
    "common_shares": 256720235,
    "preferred_shares": 0
  }
]