ipo calendar pipeline derived

{
  "input": {
    "type": "http",
    "method": "GET",
    "queryParams": {
      "sic": "4-digit SIC industry code filter.",
      "days": "Only issuers registered within this many days.",
      "limit": "How many results to return.",
      "stage": "Comma-separated pipeline stages to include, from registered, expected and dormant.",
      "cursor": "Opaque pagination cursor returned by the previous page.",
      "foreign": "true returns F-1 filers only, false returns S-1 only. Omit for both."
    }
  },
  "output": {
    "type": "object",
    "required": [
      "count",
      "companies",
      "nextCursor"
    ],
    "properties": {
      "about": {
        "type": "string",
        "description": "What this response is and where its data comes from, in one sentence."
      },
      "count": {
        "type": "integer"
      },
      "related": {
        "type": "object",
        "description": "Next steps as paths on this origin. Each is priced by its own 402 challenge; GET /.well-known/x402 prices the whole origin in one free call.",
        "additionalProperties": {
          "type": "string"
        }
      },
      "companies": {
        "type": "array",
        "items": {
          "type": "object",
          "required": [
            "cik",
            "name",
            "stage",
            "registrationForm",
            "signals"
          ],
          "properties": {
            "cik": {
              "type": "string",
              "description": "Zero-padded 10-digit issuer CIK."
            },
            "sic": {
              "type": [
                "string",
                "null"
              ]
            },
            "name": {
              "type": "string"
            },
            "spac": {
              "type": "boolean"
            },
            "edgar": {
              "type": "string"
            },
            "stage": {
              "enum": [
                "registered",
                "expected",
                "dormant"
              ],
              "type": "string"
            },
            "signals": {
              "type": "object",
              "properties": {
                "form8A12BAt": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "effectNoticeAt": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              }
            },
            "firstFiledAt": {
              "type": [
                "string",
                "null"
              ]
            },
            "amendmentCount": {
              "type": "integer"
            },
            "lastActivityAt": {
              "type": [
                "string",
                "null"
              ]
            },
            "sicDescription": {
              "type": [
                "string",
                "null"
              ]
            },
            "signalStrength": {
              "enum": [
                "strong",
                "moderate",
                "weak"
              ],
              "type": "string"
            },
            "registrationForm": {
              "enum": [
                "S-1",
                "F-1",
                null
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "foreignPrivateIssuer": {
              "type": "boolean",
              "description": "True for F-1 filers."
            }
          }
        }
      },
      "freshness": {
        "type": "object",
        "required": [
          "tier",
          "as_of",
          "age_seconds",
          "max_age_seconds"
        ],
        "properties": {
          "note": {
            "type": "string"
          },
          "tier": {
            "type": "string",
            "example": "nightly"
          },
          "as_of": {
            "type": "string",
            "description": "Newest datum this answer is based on (ISO 8601)."
          },
          "age_seconds": {
            "type": "integer",
            "minimum": 0
          },
          "max_age_seconds": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0
          }
        },
        "description": "How fresh the data is, measured when you called. `age_seconds` is the number to act on; `max_age_seconds` is the refresh cadence (null = deterministic, cannot go stale)."
      },
      "nextCursor": {
        "type": [
          "string",
          "null"
        ]
      }
    }
  }
}