> ## Documentation Index
> Fetch the complete documentation index at: https://docs.secapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /v1/offerings

> Find SEC registration statements and prospectuses for public-offering research

Find SEC registration statements and prospectuses for public-offering research

<Info>
  Audience: application and coding agent.
</Info>

## Coverage and source scope

Searches S-1 and 424B-family filing records. Results identify filed disclosures, not every capital raise or a completed offering. Preserve the accession number and source fields when reviewing a result: `filingDate` is the SEC disclosure date, not necessarily an offering or pricing date. Continue with the returned `nextCursor` value for the same filters. A lower `submission_file_limit` scans fewer SEC submission files and can omit older matches. See [API conventions](https://docs.secapi.ai/api-conventions).

## Agent mode

Pass `?view=agent` to receive the compact agent shape: offering identifiers (ticker, form, family, amendment flag, filing date, accession number, type, and title) plus prospectus and filing URLs. Company metadata and per-row provenance, freshness, and materialization blocks are omitted. See [api conventions → response formats](/api-conventions) for the full `?view=` contract.

## Canonical metadata

* `requestId`
* `traceparent`
* `provenance`
* `freshness`
* `materialization`

## Example request

<RequestExample>
  ```bash theme={null}
  curl -X GET \
    -H "x-api-key: $SECAPI_API_KEY" \
    -H "secapi-version: 2026-03-19" \
    "https://api.secapi.ai/v1/offerings?ticker=AAPL&forms=S-1,424B4&limit=10"
  ```
</RequestExample>

## Example response

<ResponseExample>
  ```json theme={null}
  {
    "object": "list",
    "data": [
      {
        "object": "offering_record",
        "ticker": "EXAMPLE",
        "form": "S-1",
        "offeringFamily": "S-1",
        "isAmendment": false,
        "filingDate": "2026-03-18",
        "accessionNumber": "0000000000-26-000001",
        "offeringType": "registration_statement",
        "title": "Example issuer registration statement",
        "prospectusUrl": "https://www.sec.gov/Archives/edgar/data/0000000/example.htm",
        "provenance": {
          "source": "sec",
          "accessionNumber": "0000000000-26-000001",
          "filingUrl": "https://www.sec.gov/Archives/edgar/data/0000000/example.htm",
          "retrievedAt": "2026-03-18T16:00:00.000Z",
          "parserVersion": "2026-03-18.1"
        }
      }
    ],
    "hasMore": false,
    "nextCursor": null,
    "requestId": "req_2ZK8Q1W9F4M6P7R3"
  }
  ```
</ResponseExample>

## Give this prompt to your agent

<Prompt>
  Use SEC API GET /v1/offerings to find filed S-1 and 424B-family registration statements and prospectuses for public-offering research. Start with a ticker or CIK, select `forms` for the filing family, and use `date_from` and `date_to` as inclusive filing-date bounds. Preserve the accession number, form, filing date, source URLs, `hasMore`, `nextCursor`, `requestId`, and `traceparent`; when present, preserve `provenance`, `freshness`, and `materialization` metadata unchanged, but do not assume those fields on response shapes that omit them. Filing records do not enumerate every capital raise or confirm an offering completed. Keep the same filters while following `nextCursor`, and note that a lower `submission_file_limit` can omit older SEC matches.
</Prompt>

## Failure posture

* treat non-2xx responses as contract-aware failures, not free-form errors
* preserve `requestId` and `traceparent` in logs and downstream reports
* if provenance or freshness metadata is present, return it unchanged so trust is not lost in the handoff