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>'
import requests

url = "https://app.tryspecter.com/api/v1/companies/{companyId}/ipos"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://app.tryspecter.com/api/v1/companies/{companyId}/ipos', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://app.tryspecter.com/api/v1/companies/{companyId}/ipos",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "https://app.tryspecter.com/api/v1/companies/{companyId}/ipos"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("X-API-Key", "<api-key>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://app.tryspecter.com/api/v1/companies/{companyId}/ipos")
.header("X-API-Key", "<api-key>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://app.tryspecter.com/api/v1/companies/{companyId}/ipos")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body
[
  {
    "ipo_id": "ipo_36f84e2b01fccf39d3d4a174",
    "company_id": "5e6afb206e2d0842bf48218a",
    "company_name": "Apple",
    "company_domain": "apple.com",
    "stock_exchange_symbol": "nasdaq",
    "stock_symbol": "AAPL",
    "went_public_on": "1980-12-12",
    "share_price_usd": 22,
    "valuation_price_usd": 1192737304,
    "money_raised_usd": 101200000
  }
]
{
"errorCode": "API_KEY_MISSING",
"message": "No API Key was presented on the header X-API-KEY"
}
{
"errorCode": "OUT_OF_CREDITS",
"message": "<string>"
}
{
"errorCode": "NOT_PERMITTED",
"message": "You do not have permission to access this resource."
}
{
"errorCode": "<string>",
"message": "<string>"
}
{
"errorCode": "<string>",
"message": "<string>"
}

Authorizations

X-API-Key
string
header
required

Path Parameters

companyId
string
required

The Specter company ID.

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_36f84e2b01fccf39d3d4a174"

company_id
string
required

The Specter company ID of the issuing company. Use with Get company by ID to fetch the full company record.

Example:

"5e6afb206e2d0842bf48218a"

company_name
string
required

The issuing company's name.

Example:

"Apple"

company_domain
string | null

The issuing company's primary domain, if known.

Example:

"apple.com"

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:

"AAPL"

went_public_on
string<date> | null

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

Example:

"1980-12-12"

share_price_usd
number | null

Initial offering share price in USD.

Example:

22

valuation_price_usd
number | null

Implied valuation at listing in USD.

Example:

1192737304

money_raised_usd
integer | null

Total proceeds from the offering in USD.

Example:

101200000