Skip to main content
GET
/
companies
/
{companyId}
/
ipos
Get company IPOs
curl --request GET \
  --url https://app.tryspecter.com/api/v1/companies/{companyId}/ipos \
  --header 'X-API-Key: <api-key>'
[
  {
    "ipo_id": "ipo_5f3a2b1c4d5e6f7a8b9c0d1e",
    "company_id": "1a2b3c4d5e6f1a2b3c4d5e6f",
    "company_name": "ListedCo",
    "company_domain": "listed.example",
    "stock_exchange_symbol": "nasdaq",
    "stock_symbol": "LSTC",
    "went_public_on": "2024-04-18",
    "share_price_usd": 42.5,
    "valuation_price_usd": 5000000000,
    "money_raised_usd": 750000000
  }
]

Documentation Index

Fetch the complete documentation index at: https://api.tryspecter.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
companyId
string
required

The ID of the company being requested

Query Parameters

​
limit
number

The number of results to return, default is 50.

​
page
number

The page number of results to return, base 0, default is 0.

Response

A page of IPOs for the company.

​
ipo_id
string
required

The Specter ID for this IPO. Stable across deliveries and usable on GET /ipos/{ipo_id}.

Example:

"ipo_5f3a2b1c4d5e6f7a8b9c0d1e"

​
company_id
string
required

The Specter company ID of the issuing company. Use with GET /companies/{companyId} to fetch the full company record.

Example:

"1a2b3c4d5e6f1a2b3c4d5e6f"

​
company_name
string
required

The issuing company's name.

Example:

"ListedCo"

​
company_domain
string | null

The issuing company's primary domain, if known.

Example:

"listed.example"

​
stock_exchange_symbol
string | null

The exchange the company listed on (lowercase, e.g. nasdaq, nyse).

Example:

"nasdaq"

​
stock_symbol
string | null

Ticker symbol of the company.

Example:

"LSTC"

​
went_public_on
string<date> | null

Date the company went public (YYYY-MM-DD).

Example:

"2024-04-18"

​
share_price_usd
number | null

Initial offering share price in USD.

Example:

42.5

​
valuation_price_usd
number | null

Implied valuation at listing in USD.

Example:

5000000000

​
money_raised_usd
integer | null

Total proceeds from the offering in USD.

Example:

750000000