IPO

IPO Profile

GET/v2/ipo/profile

Returns the full profile for a single IPO: the offering summary plus nested milestones, statement-grouped financials (income statement, balance sheet, cash flow), and the document catalog. Identify the IPO by symbol or isin. Financials are sourced from the curated hot-IPO financials and grouped per statement; each metric carries its fiscal year/period, unit, currency, and a valid flag. Documents are served separately by the /ipo/documents endpoint.

Included in: Growth.

Authentication

Send your API key in the x-api-key header on every request to https://api.bavest.co. The samples read it from the BAVEST_API_KEY environment variable. Get an API key · Authentication guide

Parameters

Name	In	Type	Required	Description
symbol	query	string	no	IPO ticker symbol (e.g., `SPCX` for SpaceX). Symbol only — ISIN is not supported for IPO endpoints. Example `SPCX`

Try it

symbol query

IPO ticker symbol (e.g., `SPCX` for SpaceX). Symbol only — ISIN is not supported for IPO endpoints.

GET /v2/ipo/profile?symbol=SPCX

API key

Sent only to api.bavest.co for this request; not stored.

Sign in to send Get an API keySends with the key above, or sign in to use your account's key. Each request counts as one API call.

curl 'https://api.bavest.co/v2/ipo/profile?symbol=SPCX' \
  -H "x-api-key: $BAVEST_API_KEY"

Samples read your key from BAVEST_API_KEY and follow the form.

Example response 200

{
  "data": {
    "symbol": "SPCX",
    "name": "Space Exploration Technologies Corp.",
    "exchange": null,
    "regulator": "SEC",
    "filingType": "S-1",
    "status": "Expected",
    "priceType": "fixed",
    "priceLow": 135,
    "priceHigh": 135,
    "currency": "USD",
    "numberOfShares": 556600000,
    "grossProceeds": 75141000000,
    "impliedValuation": 1750000000000,
    "confidentialFilingDate": "2026-04-01",
    "publicFilingDate": "2026-05-20",
    "milestones": [
      {
        "stage": "subscription",
        "label": "Collecting subscriptions",
        "startsAt": null,
        "endsAt": "2026-06-10T17:00:00+00:00",
        "expectedDate": null,
        "source": "EU prospectus"
      },
      {
        "stage": "pricing",
        "label": "Setting price and allocation",
        "startsAt": null,
        "endsAt": null,
        "expectedDate": "2026-06-11",
        "source": "S-1"
      }
    ],
    "financials": {
      "incomeStatement": [
        {
          "metric_name": "accountsPayable",
          "value": 10002000000,
          "value_type": "currency",
          "currency": "USD",
          "unit": "USD",
          "fiscal_year": 2026,
          "fiscal_period": "Q1",
          "period_end_date": "2026-03-31",
          "source": "SpaceX prospectus (S-1) 2026-06-05, consolidated balance sheet",
          "valid": true
        },
        {
          "metric_name": "accountsPayable",
          "value": 11792000000,
          "value_type": "currency",
          "currency": "USD",
          "unit": "USD",
          "fiscal_year": 2025,
          "fiscal_period": "FY",
          "period_end_date": "2025-12-31",
          "source": "SpaceX prospectus (S-1) 2026-06-05, consolidated balance sheet",
          "valid": true
        }
      ],
      "balanceSheet": [
        {
          "metric_name": "cashAndCashEquivalents",
          "value": 15852000000,
          "value_type": "currency",
          "currency": "USD",
          "unit": "USD",
          "fiscal_year": 2026,
          "fiscal_period": "Q1",
          "period_end_date": "2026-03-31",
          "source": "SpaceX EU retail prospectus summary, Bafin-approved 2026-06-05, section B.2",
          "valid": true
        },
        {
          "metric_name": "cashAndCashEquivalents",
          "value": 24747000000,
          "value_type": "currency",
          "currency": "USD",
          "unit": "USD",
          "fiscal_year": 2025,
          "fiscal_period": "FY",
          "period_end_date": "2025-12-31",
          "source": "SpaceX EU retail prospectus summary, Bafin-approved 2026-06-05, section B.2",
          "valid": true
        }
      ],
      "cashFlow": [
        {
          "metric_name": "capex",
          "value": 10107000000,
          "value_type": "currency",
          "currency": "USD",
          "unit": "USD",
          "fiscal_year": 2026,
          "fiscal_period": "Q1",
          "period_end_date": "2026-03-31",
          "source": "SpaceX EU retail prospectus summary, Bafin-approved 2026-06-05, section B.2",
          "valid": true
        },
        {
          "metric_name": "capex",
          "value": 20737000000,
          "value_type": "currency",
          "currency": "USD",
          "unit": "USD",
          "fiscal_year": 2025,
          "fiscal_period": "FY",
          "period_end_date": "2025-12-31",
          "source": "SpaceX EU retail prospectus summary, Bafin-approved 2026-06-05, section B.2",
          "valid": true
        }
      ]
    }
  },
  "meta": {
    "parameters": {
      "symbol": "SPCX"
    },
    "time": 2314
  }
}

From the docs, not your data. Long lists are cut to 3 items.

Response 200

Successful response · application/json

dataIPOProfile
Full single-IPO detail — offering plus nested milestones and statement-grouped financials. Documents are served separately by the /ipo/documents endpoint.
- symbolstringrequired
  Example SPCX
- namestring | null
  Example Space Exploration Technologies Corp.
- exchangeinteger | null
- regulatorstring | null
  Example SEC
- filingTypestring | null
  Example S-1
- statusstring | null
  Example Expected
- priceTypestring | null
  Example fixed
- priceLownumber (double) | null
  Example 135
- priceHighnumber (double) | null
  Example 135
- currencystring | null
  Example USD
- numberOfSharesinteger | null
  Example 556600000
- grossProceedsnumber (double) | null
  Example 75141000000
- impliedValuationnumber (double) | null
  Example 1750000000000
- confidentialFilingDatestring (date) | null
  Example 2026-04-01
- publicFilingDatestring (date) | null
  Example 2026-05-20
- milestonesarray of IPOMilestone
- financialsIPOFinancials
  Statement-grouped financials (income statement, balance sheet, cash flow)
metaResponseMeta
Response envelope metadata. Always present on a 200: time is set by core/response.py on every successful response. Errors carry the same block, built by the same code, so a client parses one meta shape whether the call succeeded or failed.
- timeinteger
  Server-side processing time in milliseconds
  Example 17
- parametersobject
  Echo of the request parameters the endpoint resolved

Errors

400Invalid request parameters. Returned when required query parameters are missing, have invalid types, or violate constraints (e.g., providing both symbol and isin when they are mutually exclusive).
401Missing or invalid API key.
404Resource not found.
429Rate limit exceeded. Retry after the `Retry-After` header interval.
500An unexpected error occurred on the server. If the issue persists, contact support with the X-Request-Id header value.
502Upstream data provider returned an error or is temporarily unavailable. Retry after a short delay.
504The request timed out waiting for a response from the upstream data provider. This may occur for complex queries or during peak load.
defaultAn unexpected error occurred on the server. If the issue persists, contact support with the X-Request-Id header value.