IPO Filings API

Real‑time SEC filing data for VCs, investment bankers, and institutional investors.

Base URL: https://parheliaweb.com

All requests must include an API key in the x-api-key header. Responses are in JSON.

🚀 Quick Start (Free):

Subscribe free at /register — no card required
Get your universal API key in the portal
Query this API — 100/day free, access to the latest 30 days
Upgrade anytime — same key, more quota, historical data unlocked

🗝️ Universal API Key: Your ParheliaWeb key works across all six APIs — this one, Email Validation, Funding, Layoffs, Fines, and Acquisitions. A free tier is available for each of these APIs. Manage usage for all APIs in the portal.

🌐 Localization Support: Append ?lang=zh to any request URL to automatically receive industry terms, regions, and AI-translated summaries in Simplified Chinese.

ℹ️ Note: ticker, exchange_mic, and exchange_name always remain in their internationally recognised format (e.g. NASDAQ, XNAS, FLY) and are never translated by the lang parameter.

💶 Pricing & Currency

All prices are listed in Euros (EUR). Your card will be charged in your local currency at the prevailing exchange rate. We use Stripe for secure payment processing, which supports 135+ currencies and local payment methods including iDEAL, Bancontact, and SEPA Direct Debit.

EU-Based: ParheliaWeb is built and hosted in the Netherlands. All data processing complies with GDPR. Our servers are located in Dutch data centers, ensuring low latency for European customers and full compliance with EU data protection regulations.

🔐 Authentication

Pass your secret API key as an HTTP header on every request:

x-api-key: YOUR_API_KEY

If the key is missing or invalid, you'll receive a 401 Unauthorized or 403 Forbidden.

📡 Rate Limits & Access

Your daily quota depends on your subscription tier, while the rate limit exists to prevent abuse (e.g. using the API as a DDoS bot). The two are independent: exhausting your daily quota requires waiting until the next day, whereas exceeding the rate limit only requires a short cooldown.

Plan	Daily Quota	Rate Limit	Data Access	Fields	Support
Free	100 calls / day	60 requests / minute	Last 30 days only	Basic (company, filing type, date, url)	—
Pro (€29/month)	1,000 calls / day	60 requests / minute	Full dataset (up to 10 years)	+ ticker, exchange MIC, exchange name, status, sector, country, country of incorporation, underwriters, shares, price range, direct listing, SPAC flag	Email support

When the request rate exceeds the rate limit, the API returns 429 Too Many Requests. Simply retry after a short wait — this does not consume your daily quota.

Why our free tier isn't like others: Most data APIs give free users stale snapshots, synthetic demo rows, or 14-day trials that expire mid-project. We give you the same live SEC pipeline our paying customers use — 100 queries/day, forever, refreshed on the same 4x-daily crawl. You only pay when you need the extended fields and full history.

📦 Endpoint: Get IPO Filings

GET /v1/ipos

Returns the most recent S-1 and F-1 filings from the SEC EDGAR system, including ticker and listing exchange details. Currently tracking 37 IPO filings.

Query Parameters

Parameter	Type	Default	Description
`max_age_days`	integer	365	Maximum age of data in days. Free tier limited to 30 days. Pro tier: up to 3650 (10 years).
`max_records`	integer	500	Maximum records returned. Range: 1-5000.
`lang`	string	en	Optional. Set to `zh` to return localized fields in Simplified Chinese (`ticker`, `exchange_mic`, and `exchange_name` are excluded and always remain in their international format).

Example Requests

# Get IPO filings (default: 365 days for Pro, 30 days for Free)
curl -H "x-api-key: YOUR_KEY" https://parheliaweb.com/v1/ipos

# Get IPO filings from the last 30 days only
curl -H "x-api-key: YOUR_KEY" "https://parheliaweb.com/v1/ipos?max_age_days=30"

# Pro tier: Get all records (up to 10 years) & return Simplified Chinese
curl -H "x-api-key: YOUR_KEY" "https://parheliaweb.com/v1/ipos?max_age_days=3650&lang=zh"

Example Response (Pro tier)

{
  "user_tier": "pro",
  "count": 1,
  "max_age_days": 365,
  "last_crawled": "2026-05-28T15:13:19Z",
  "results": [{
    "company_name": "Firefly Aerospace",
    "filing_type": "S-1",
    "filing_date": "2026-05-28",
    "ticker": "FLY",
    "exchange_mic": "XNAS",
    "exchange_name": "NASDAQ",
    "description": null,
    "source_url": "https://www.sec.gov/Archives/edgar/data/...",
    "source_status": "active",
    "ipo_status": "Filed",
    "sector": "Aerospace",
    "country": "US",
    "country_incorporation": "US",
    "lead_underwriters": "Goldman Sachs",
    "shares_offered": "20M",
    "price_range": "$17-$19",
    "is_direct_listing": false,
    "is_spac": false
  }]
}

Response Fields

Field	Type	Description
`user_tier`	string	Your subscription tier (free, pro)
`count`	integer	Number of results returned
`max_age_days`	integer	The max age filter applied (capped at 30 for Free tier)
`last_crawled`	string	ISO 8601 timestamp (UTC) of the last crawler run
`company_name`	string	Company filing for IPO
`filing_type`	string	S-1 (US) or F-1 (foreign)
`filing_date`	string	Date of SEC filing (YYYY-MM-DD)
`ticker`	string\|null	Pro tier: Stock ticker symbol (e.g. `FLY`). Null if not yet determined at time of filing.
`exchange_mic`	string\|null	Pro tier: ISO 10383 Market Identifier Code for the listing exchange (e.g. `XNAS`, `XNYS`).
`exchange_name`	string\|null	Pro tier: Full name of the listing exchange (e.g. `NASDAQ`, `New York Stock Exchange`).
`description`	string\|null	Additional description
`source_url`	string	Direct link to SEC EDGAR filing
`source_status`	string	"active" — SEC filings are permanently archived
`ipo_status`	string\|null	Pro tier: Filed, Priced, or Trading
`sector`	string\|null	Pro tier: Industry sector
`country`	string\|null	Pro tier: Country of the stock exchange where the IPO is filed (e.g., US for NASDAQ/NYSE)
`country_incorporation`	string\|null	Pro tier: Country where the company is legally incorporated (may differ from listing country)
`lead_underwriters`	string\|null	Pro tier: Investment banks leading the IPO
`shares_offered`	string\|null	Pro tier: Number of shares in offering
`price_range`	string\|null	Pro tier: Expected price range per share
`is_direct_listing`	boolean	Pro tier: True if direct listing
`is_spac`	boolean	Pro tier: True if SPAC merger

Data Source: IPO filings are sourced directly from the SEC EDGAR system. Our AI filters out SPACs and non-IPO filing types to ensure data quality.

AI-Verified Data: Every filing is cross-checked by DeepSeek AI. Pro tier fields are extracted from the filing metadata.

💻 Code Snippets

Python

import requests
headers = {"x-api-key": "YOUR_API_KEY"}
resp = requests.get("https://parheliaweb.com/v1/ipos", headers=headers)
for item in resp.json()["results"]:
    print(item["company_name"], item["filing_type"], item["filing_date"])

JavaScript (fetch)

fetch("https://parheliaweb.com/v1/ipos", {
  headers: { "x-api-key": "YOUR_API_KEY" }
})
.then(res => res.json())
.then(data => console.log(data.results));

cURL

curl -H "x-api-key: YOUR_API_KEY" https://parheliaweb.com/v1/ipos

🗝️ Your Key Works Across All ParheliaWeb APIs

Your API key isn't limited to this API. Use it across our full platform:

API	Endpoint Base	Free Tier	Pro Tier
IPOs	`/v1/ipos`	100/day	1,000/day
Email Validation	`/v1/email/validate`	100/mo	25,000/mo
Funding Rounds	`/v1/funding`	100/day	1,000/day
Layoffs	`/v1/layoffs`	100/day	1,000/day
Regulatory Fines	`/v1/fines`	100/day	1,000/day
Acquisitions	`/v1/acquisitions`	100/day	1,000/day

Quotas are per-API. Upgrade each API independently based on your needs. Why different quotas? Email validation performs live SMTP handshakes — per-check infrastructure cost. Data APIs query our cached database — lower marginal cost.

📬 Support

If you run into any issues or have feature suggestions, email us at info@parheliaweb.com.

IPO Filings API by ParheliaWeb · Built in the Netherlands · Terms · Privacy · Why Choose Us · Contact