IPOGrid IPO Calendar & Filing Research

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'group': {'enum': ['sector', 'form_family', 'status'], 'type': 'string', 'description': 'Dimension used to split chart series. Defaults to sector for proceeds/returns and form_family for filing counts.'}, 'range': {'enum': ['13w', '26w', '52w'], 'type': 'string', 'description': 'Trailing window when explicit dates are omitted. Defaults to 26w; anonymous 52w requests are clamped to 26w.'}, 'scope': {'enum': ['all', 'active'], 'type': 'string', 'description': 'Include all matching records or only active offerings. Defaults to active.'}, 'bucket': {'enum': ['day', 'week', 'month', 'quarter'], 'type': 'string', 'description': 'Time interval. Defaults to week; anonymous daily requests require an explicit window of at most 31 days or are clamped to week.'}, 'issuer': {'enum': ['all', 'exclude_spacs'], 'type': 'string', 'description': 'Include every issuer or exclude SPACs. Defaults to all.'}, 'metric': {'enum': ['gross_proceeds', 'prospectus_count', 'final_prospectus_count', 'day1_return_pct'], 'type': 'string', 'description': 'Value to aggregate. Defaults to gross_proceeds.'}, 'date_to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Inclusive YYYY-MM-DD upper bound. Use with date_from for a custom window instead of range.'}, 'date_from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Inclusive YYYY-MM-DD lower bound. Use with date_to for a custom window instead of range.'}, 'materiality': {'enum': ['all', 'major'], 'type': 'string', 'description': 'Include all filing forms or only major IPO forms. Defaults to all.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data', 'links'], 'properties': {'data': {'type': 'object', 'required': ['spec', 'title', 'subtitle', 'unit', 'points', 'summary'], 'properties': {'spec': {'type': 'object', 'description': 'Normalized chart filters actually applied to the query.', 'additionalProperties': {}}, 'unit': {'enum': ['count', 'usd', 'percent'], 'type': 'string', 'description': 'Unit used by point values and summary.total.'}, 'title': {'type': 'string', 'description': 'Display title for the chart.'}, 'points': {'type': 'array', 'items': {'type': 'object', 'required': ['period', 'series', 'value'], 'properties': {'value': {'type': 'number', 'description': 'Aggregated value for this bucket and series.'}, 'period': {'type': 'string', 'description': 'Date bucket label.'}, 'series': {'type': 'string', 'description': 'Grouped series label.'}}, 'additionalProperties': False}}, 'summary': {'type': 'object', 'required': ['total', 'periods', 'series'], 'properties': {'total': {'type': 'number', 'description': 'Total or average across returned points.'}, 'series': {'type': 'integer', 'minimum': 0}, 'periods': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'subtitle': {'type': 'string', 'description': 'Display subtitle describing the filters.'}}, 'additionalProperties': False}, 'links': {'type': 'object', 'required': ['embedUrl', 'pageUrl', 'apiUrl'], 'properties': {'apiUrl': {'type': 'string', 'description': 'Chart JSON API URL.'}, 'pageUrl': {'type': 'string', 'description': 'Public chart page URL.'}, 'embedUrl': {'type': 'string', 'description': 'Embeddable chart URL.'}}, 'additionalProperties': False}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['cik'], 'properties': {'cik': {'type': 'string', 'description': 'SEC Central Index Key, with or without leading zeroes (for example 1907085 or 0001907085).'}, 'include': {'type': 'array', 'items': {'enum': ['latest_terms', 'classification', 'consensus', 'financial_snapshot', 'filings', 'news', 'comps', 'lockup_schedule'], 'type': 'string'}, 'description': 'Optional detail sections. Authenticated lockup_schedule includes normalized holder classes, numeric tranche quantities, resolved dates, anchors and offsets, exceptions, conditions, and evidence. Anonymous requests silently omit consensus, financial_snapshot, filings, comps, and lockup_schedule.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'type': 'object', 'properties': {'lockupSchedule': {'anyOf': [{'type': 'object', 'required': ['releaseSchedule', 'source', 'earliestMaterialReleaseDate'], 'properties': {'source': {'type': 'object', 'required': ['accessionNumber', 'filingDate', 'formType', 'primaryDocument', 'secUrl'], 'properties': {'secUrl': {'type': 'string', 'format': 'uri'}, 'formType': {'type': 'string'}, 'filingDate': {'type': 'string'}, 'accessionNumber': {'type': 'string'}, 'primaryDocument': {'type': 'string'}}, 'additionalProperties': False}, 'evidence': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockedParties'}, 'confidence': {'type': 'number', 'default': 0, 'maximum': 1, 'minimum': 0}, 'exceptions': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockedParties'}, 'startAnchor': {'anyOf': [{'enum': ['prospectus_date', 'pricing_date', 'closing_date', 'first_trade_date', 'other', 'unknown'], 'type': 'string'}, {'type': 'null'}], 'default': None}, 'lockupGroups': {'type': 'array', 'items': {'type': 'object', 'properties': {'evidence': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockedParties'}, 'exceptions': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockedParties'}, 'releaseDate': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodText'}, 'startAnchor': {'anyOf': [{'enum': ['prospectus_date', 'pricing_date', 'closing_date', 'first_trade_date', 'other', 'unknown'], 'type': 'string'}, {'type': 'null'}], 'default': None}, 'holderClassKey': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodText'}, 'ownershipScope': {'enum': ['exclusive_class', 'aggregate', 'subset', 'unknown'], 'type': 'string', 'default': 'unknown'}, 'releaseDateText': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodText'}, 'startAnchorDate': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodText'}, 'startAnchorText': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodText'}, 'lockupPeriodDays': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodDays'}, 'lockupPeriodText': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodText'}, 'partyDescription': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodText'}, 'transferExceptions': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockedParties'}, 'securityDescription': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodText'}, 'earlyReleaseTriggers': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockedParties'}, 'parentHolderClassKey': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodText'}, 'percentOfOutstanding': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodDays'}, 'sharesSubjectToLockup': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodDays'}}, 'additionalProperties': False}, 'default': []}, 'foundAnything': {'type': 'boolean', 'default': False}, 'lockedParties': {'type': 'array', 'items': {'type': 'string'}, 'default': []}, 'consentParties': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockedParties'}, 'sourceSections': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockedParties'}, 'releaseSchedule': {'type': 'array', 'items': {'type': 'object', 'required': ['resolvedReleaseDate', 'isDateEstimated'], 'properties': {'evidence': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockedParties'}, 'anchorDate': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodText'}, 'conditions': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockedParties'}, 'offsetDays': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodDays'}, 'anchorEvent': {'anyOf': [{'enum': ['ipo_date', 'prospectus_date', 'pricing_date', 'closing_date', 'first_trade_date', 'business_combination_completion_date', 'offering_sales_commencement_date', 'earnings_release_date', 'explicit_date', 'other', 'unknown'], 'type': 'string'}, {'type': 'null'}], 'default': None}, 'releaseDate': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodText'}, 'offsetMonths': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodDays'}, 'releaseScope': {'enum': ['specified_shares', 'issuer_outstanding', 'holder_class', 'all_restricted_shares', 'all_shareholders', 'unknown'], 'type': 'string', 'default': 'unknown'}, 'holderClassKey': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodText'}, 'quantitySource': {'enum': ['explicit', 'derived', 'unresolved'], 'type': 'string', 'default': 'unresolved'}, 'isDateEstimated': {'type': 'boolean'}, 'releaseDateText': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodText'}, 'holderCategories': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockedParties'}, 'materialityBasis': {'enum': ['percent_of_outstanding', 'share_count', 'complete_holder_class', 'all_restricted_shares', 'all_shareholders', 'unquantified_partial_holder_class', 'unresolved'], 'type': 'string', 'default': 'unresolved'}, 'holderClassShares': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodDays'}, 'isCompleteRelease': {'type': ['boolean', 'null'], 'default': None}, 'offsetTradingDays': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodDays'}, 'releaseTimingText': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodText'}, 'anchorReferenceDate': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodText'}, 'resolvedReleaseDate': {'type': ['string', 'null']}, 'estimatedReleaseDate': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodText'}, 'materialityConfidence': {'enum': ['high', 'medium', 'low'], 'type': 'string', 'default': 'low'}, 'sharesEligibleForSale': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodDays'}, 'releasePercentOfHolderClass': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodDays'}, 'releasePercentOfOutstanding': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodDays'}, 'holderClassPercentOfOutstanding': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodDays'}}, 'description': 'One normalized release tranche, including quantities, holder linkage, anchor offsets, conditions, and a resolved exact or estimated calendar date.', 'additionalProperties': False}}, 'releasedParties': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockedParties'}, 'startAnchorDate': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodText'}, 'startAnchorText': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodText'}, 'lockupPeriodDays': {'type': ['number', 'null'], 'default': None}, 'lockupPeriodText': {'type': ['string', 'null'], 'default': None}, 'ownershipSummary': {'anyOf': [{'type': 'object', 'required': ['reconciliationStatus', 'excludedAggregateOrSubsetRows'], 'properties': {'reconciliationStatus': {'enum': ['consistent', 'partial', 'conflict', 'unknown'], 'type': 'string'}, 'restrictedSharesTotal': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodDays'}, 'excludedAggregateOrSubsetRows': {'type': 'integer', 'minimum': 0}, 'restrictedPercentOfOutstanding': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodDays'}, 'totalSharesOutstandingPostOffering': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodDays'}}, 'additionalProperties': False}, {'type': 'null'}], 'default': None}, 'transferExceptions': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockedParties'}, 'earlyReleaseTriggers': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockedParties'}, 'lockupAgreementsFound': {'type': ['boolean', 'null'], 'default': None}, 'earliestMaterialReleaseDate': {'type': ['string', 'null']}, 'aggregatePercentOfOutstanding': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodDays'}, 'aggregateSharesSubjectToLockup': {'$ref': '#/properties/data/properties/lockupSchedule/anyOf/0/properties/lockupPeriodDays'}}, 'description': 'Complete normalized offering-document lockup terms: ownership classes, numeric quantities, exact or estimated release dates, anchors and offsets, transfer exceptions, triggers, conditions, and source evidence. Available only through authenticated API and MCP access.', 'additionalProperties': False}, {'type': 'null'}], 'description': 'Complete normalized offering-document lockup terms: ownership classes, numeric quantities, exact or estimated release dates, anchors and offsets, transfer exceptions, triggers, conditions, and source evidence. Available only through authenticated API and MCP access.'}}, 'description': 'Issuer detail with the requested and permitted enrichment sections.', 'additionalProperties': {}}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'kind': {'type': 'array', 'items': {'enum': ['operating', 'spac', 'funds', 'follow_on'], 'type': 'string'}, 'description': 'Return only these issuer kinds. Omit to include every kind.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum rows to return. Defaults to 50 when authenticated; anonymous requests are capped at 10.'}, 'scope': {'enum': ['ipo', 'all'], 'type': 'string', 'description': 'Filter to IPO-only rows or all active deal rows.'}, 'cursor': {'type': 'string', 'description': 'Opaque next_cursor from a previous response. Omit for the first page.'}, 'market': {'enum': ['all', 'exchange', 'otc', 'unknown'], 'type': 'string', 'description': 'Filter by normalized market family.'}, 'include': {'type': 'array', 'items': {'enum': ['latest_terms', 'classification', 'consensus'], 'type': 'string'}, 'description': 'Optional enrichments for each row. Anonymous requests silently omit consensus.'}, 'updated_since': {'type': 'string', 'description': 'ISO-8601 lower bound on the company update timestamp.'}, 'gross_proceeds_gt': {'type': 'number', 'description': 'Lower bound on gross proceeds, using stated gross proceeds or a midpoint estimate from price range times shares offered.', 'exclusiveMinimum': 0}, 'gross_proceeds_lt': {'type': 'number', 'description': 'Upper bound on gross proceeds, using stated gross proceeds or a midpoint estimate from price range times shares offered.', 'exclusiveMinimum': 0}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data', 'next_cursor', 'has_more', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': {}}, 'description': 'Rows for the current page.'}, 'meta': {'type': 'object', 'required': ['count'], 'properties': {'count': {'type': 'integer', 'minimum': 0, 'description': 'Number of rows returned in this page.'}}, 'additionalProperties': False}, 'has_more': {'type': 'boolean', 'description': 'Whether another page is available.'}, 'next_cursor': {'type': ['string', 'null'], 'description': 'Opaque cursor for the next page, or null when this is the last page.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'cik': {'type': 'string', 'description': 'Optional SEC CIK filter, with or without leading zeroes.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum rows to return. Defaults to 50 when authenticated; anonymous requests are capped at 10.'}, 'cursor': {'type': 'string', 'description': 'Opaque next_cursor from a previous response. Omit for the first page.'}, 'include': {'type': 'array', 'items': {'enum': ['content'], 'type': 'string'}, 'description': 'Set to ["content"] for stored article body text. Anonymous requests omit content.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data', 'next_cursor', 'has_more', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': {}}, 'description': 'Rows for the current page.'}, 'meta': {'type': 'object', 'required': ['count'], 'properties': {'count': {'type': 'integer', 'minimum': 0, 'description': 'Number of rows returned in this page.'}}, 'additionalProperties': False}, 'has_more': {'type': 'boolean', 'description': 'Whether another page is available.'}, 'next_cursor': {'type': ['string', 'null'], 'description': 'Opaque cursor for the next page, or null when this is the last page.'}}, 'additionalProperties': False}