Skip to main content
GET
Python (SDK)

Authorizations

Authorization
string
header
required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

Query Parameters

identifier
string
required

Identifier value for the company you're querying. The format depends on identifierType:

  • Symbol — exchange ticker (e.g. AAPL).
  • CUSIP — 9-character U.S./Canadian identifier (e.g. 037833100).
  • ISIN — 12-character international identifier (e.g. US0378331005).
  • SEDOL — 7-character UK identifier.
  • Valoren — Swiss security identifier.
  • FIGI — Bloomberg Financial Instrument Global Identifier.
  • CompositeFIGI — country-level composite FIGI.

Must match the kind selected in identifierType.

Example:

"AAPL"

identifierType
enum<string>
required

Tells the API how to interpret identifier. See TenderOfferIdentifierType for the full set of supported values and what each one means. Which kind of identifier you are filtering by. Provide the matching value in the identifier field:

  • Symbol — exchange ticker (e.g. AAPL).
  • CUSIP — 9-character U.S./Canadian security identifier.
  • ISIN — 12-character international identifier.
  • SEDOL — 7-character UK identifier.
  • Valoren — Swiss identifier.
  • FIGI — Bloomberg Financial Instrument Global Identifier.
  • CompositeFIGI — country-level composite FIGI.
Available options:
Symbol,
CUSIP,
ISIN,
SEDOL,
Valoren,
FIGI,
CompositeFIGI
Example:

"Symbol"

startDate
string<date>
required

Start of the tender-offer announcement window, inclusive. Format: YYYY-MM-DD (e.g. 2024-01-01).

Example:

"2024-01-01"

endDate
string<date>
required

End of the tender-offer announcement window, inclusive. Format: YYYY-MM-DD (e.g. 2024-12-31).

Example:

"2024-12-31"

Response

Tender offers data.

Tender offers found for the requested security and date window.

tenderOffers
object[]
required

List of tender offer records

security
object

Security the tender offers relate to