# Forms S-1 and 424B4 - Registrations and Prospectuses API Reference | SEC API

> Complete API reference for the SEC Form S-1, F-1, S-11 and 424B4 Data API. Every request parameter, every searchable field and every response attribute, with types, constraints and a live example response.

Source: https://sec-api.io/api-reference/form-s1-424b4

Offerings and capital raises

POST`https://api.sec-api.io/form-s1-424b4`

Search structured data extracted from every Form S-1, F-1 and S-11 registration statement and every Form 424B4 prospectus filed with the SEC. The data covers offering amounts, securities offered, underwriters, law firms, auditors, employee counts and management. New data is searchable less than 500 milliseconds after EDGAR publishes the filing.

[Read the guide for this API →](https://sec-api.io/docs/form-s1-424b4-data-search-api)

## Authentication

Send the API key either as a header or as a query parameter. The header is preferred; the query parameter exists for cases where a header cannot be set, such as opening a URL directly in a browser.

Authorization: required header

The API key on its own. Do not prefix it with Bearer or any other word.

Example `Authorization: YOUR_API_KEY`

token: optional query parameter

The API key, appended to the URL. Use this only when a header is not possible.

## Request body

A JSON object. Content-Type must be application/json.

query: required string

The search expression in Lucene syntax. Every field listed under Searchable fields can be used, combined with AND, OR, NOT, ranges, wildcards and grouping.

Example `formType:424B4 AND filedAt:[2022-01-01 TO 2022-12-31]`

from: string, Maximum 10000

Index of the first result to return, used for pagination. Increment by the value of size to page through results. A single query returns at most 10000 results. Narrow the search with a filedAt range when more filings match.

Default `"0"`

size: string, Maximum 50

Number of items to return in one response.

Default `"50"`

sort: array of object

Sort order. Each item maps one field to an order object, for example [{ "publicOfferingPrice.total": { "order": "desc" } }].

Default `[{ "filedAt": { "order": "desc" } }]`

order: string

Either asc or desc.

## Searchable fields

Every field below can be used inside query. 37 fields are searchable, and they match the structure of the objects returned in the response.

| Field | Description |
| --- | --- |
| `accessionNo` | Filing accession number |
| `formType` | Form type — "S-1", "S-1/A", "F-1", "F-1/A", "S-11", "S-11/A", "424B4" |
| `filedAt` | Filing acceptance timestamp (ISO 8601) |
| `cik` | Issuer CIK (leading zeros stripped) |
| `ticker` | Issuer trading symbol at time of indexation |
| `entityName` | Issuer legal name |
| `filingUrl` | URL to the filing on SEC.gov |
| `tickers.ticker` | Ticker of an offered security |
| `tickers.type` | Security type, e.g. "Common Stock", "Ordinary Shares" |
| `tickers.exchange` | Exchange — "NASDAQ", "NYSE", etc. |
| `securities.name` | Free-text description of an offered security |
| `publicOfferingPrice.perShare` | Public offering price per share (USD, numeric) |
| `publicOfferingPrice.perShareText` | Public offering price per share (string with currency) |
| `publicOfferingPrice.total` | Total public offering price (USD, numeric) |
| `publicOfferingPrice.totalText` | Total public offering price (formatted string) |
| `underwritingDiscount.perShare` | Underwriting discount per share (numeric) |
| `underwritingDiscount.total` | Total underwriting discount (numeric) |
| `proceedsBeforeExpenses.perShare` | Proceeds before expenses per share (numeric) |
| `proceedsBeforeExpenses.total` | Total proceeds before expenses (numeric) |
| `underwriters.name` | Underwriter name (lead is first item in array) |
| `lawFirms.name` | Legal counsel / law firm name |
| `lawFirms.location` | Law firm location |
| `auditors.name` | Auditor name |
| `management.name` | Name of a management team member |
| `management.age` | Age of a management team member |
| `management.position` | Position / title (free text — not standardized) |
| `employees.total` | Total number of employees disclosed |
| `employees.asOfDate` | As-of date for the employee count |
| `employees.perDivision.division` | Business division name |
| `employees.perDivision.employees` | Employees in that division |
| `employees.perRegion.region` | Geographic region name |
| `employees.perRegion.employees` | Employees in that region |
| `id` | System-internal unique identifier of the item. |
| `underwritingDiscount.perShareText` | The underwriting discount per share as a string, for example $10.00. |
| `underwritingDiscount.totalText` | The total underwriting discount as a string, for example $152,428,000.00. |
| `proceedsBeforeExpenses.perShareText` | The proceeds before expenses per share as a string, for example $10.00. |
| `proceedsBeforeExpenses.totalText` | The total proceeds before expenses as a string, for example $152,428,000.00. |

## Response

A JSON object. Nested attributes are collapsed; expand one to see its fields.

total: object

How many filings matched the query.

value: integer

Number of matching filings.

relation: string

Either eq, meaning value is exact, or gte, meaning value is a floor.

data: array of object

The matching filings, at most size per response. Each item holds the structured data extracted from one registration statement or prospectus.

id: string

System-internal unique identifier of the item.

accessionNo: string

Accession number of the filing, for example 0001628280-24-023559.

filedAt: string

Date and time EDGAR accepted the filing for processing, ISO 8601 in Eastern Time, for example 2024-05-15T16:17:15-04:00.

formType: string

EDGAR form type, for example S-1, S-1/A, F-1, F-1/A, S-11, S-11/A or 424B4.

cik: string

Central Index Key (CIK) of the issuer, leading zeros removed.

ticker: string

Trading symbol of the issuer at the time the filing was indexed, for example TSLA.

entityName: string

Name of the issuer, for example TESLA MOTORS INC.

filingUrl: string

URL of the filing on sec.gov.

tickers: array of object

Ticker symbols of the securities, their types and the exchanges they trade on or are being listed on. Each item is one security offered by the issuer, such as common stock, preferred stock, warrants or debt securities.

ticker: string

Ticker symbol of the security being offered, for example TSLA.

type: string

Type of the security being offered, for example Common Stock.

exchange: string

Exchange the security trades on or is being listed on, for example NASDAQ.

securities: array of object

Securities offered and referred to in the filing. Each item is one security type and normally includes the number of shares, warrants or other securities offered.

name: string

One type of security offered or referred to in the filing, for example Up to 3,409,091 Shares of Common Stock.

publicOfferingPrice: object

The public offering price. Not all Form S-1 filings state it. Form 424B4 filings normally do.

perShare: number

The public offering price per share as a floating number. The value is normally in US dollars. In rare cases it is in another currency, and perShareText carries the currency symbol.

perShareText: string

The public offering price per share as a string, for example $10.00.

total: number

The total public offering price as a floating number.

totalText: string

The total public offering price as a string, for example $152,428,000.00.

underwritingDiscount: object

The underwriting discount. Not all Form S-1 filings state it. Form 424B4 filings do.

perShare: number

The underwriting discount per share as a floating number. The value is normally in US dollars. In rare cases it is in another currency, and perShareText carries the currency symbol.

perShareText: string

The underwriting discount per share as a string, for example $10.00.

total: number

The total underwriting discount as a floating number.

totalText: string

The total underwriting discount as a string, for example $152,428,000.00.

proceedsBeforeExpenses: object

Proceeds before expenses to the company. Not all Form S-1 filings state them. Form 424B4 filings do.

perShare: number

The proceeds before expenses per share as a floating number. The value is normally in US dollars. In rare cases it is in another currency, and perShareText carries the currency symbol.

perShareText: string

The proceeds before expenses per share as a string, for example $10.00.

total: number

The total proceeds before expenses as a floating number.

totalText: string

The total proceeds before expenses as a string, for example $152,428,000.00.

underwriters: array of object

Underwriters involved in the offering. The first item is normally the lead underwriter. Not all registration statements list underwriters. A later Form S-1/A can add them once they are known.

name: string

Name of the underwriter, for example Goldman Sachs & Co. LLC.

lawFirms: array of object

Legal counsel and law firms involved in the offering, with their locations.

name: string

Name of the law firm, for example Wilson Sonsini Goodrich & Rosati.

location: string

Location of the law firm, for example California, USA. Empty when the filing does not state it.

auditors: array of object

Auditors involved in the offering.

name: string

Name of the auditor, for example Deloitte & Touche LLP.

management: array of object

The management team, when the filing discloses it. Each item is one member of the team.

name: string

Name of the person, for example Elon Musk.

age: number

Age of the person, for example 50.

position: string

Position of the person in the company, for example CEO. Positions are not standardised and vary between companies. The same role can appear as President, Chief Executive Officer or CEO.

employees: object

Employee counts, in total, per business division and per geographic region, when the filing discloses them.

total: number

Total number of employees, for example 1010.

asOfDate: string

Date the total number of employees was reported as of, for example 2022-05-15. Empty when the date is not available.

perDivision: array of object

Employees per business division, when the filing discloses them. Each item is one division.

division: string

Name of the business division, for example Research and Development.

employees: number

Number of employees in the business division, for example 413.

perRegion: array of object

Employees per geographic region, when the filing discloses them. Each item is one region.

region: string

Name of the geographic region, for example Europe or Los Angeles.

employees: number

Number of employees in the geographic region, for example 56.

## Status codes

|  |  |
| --- | --- |
| `200` | Success. The response holds total and data. |
| `400` | The request body could not be parsed, or the Lucene expression in query is malformed. |
| `403` | The API key is missing, or it is not valid. |
| `429` | Too many requests. Slow the request rate and retry. |
| `500` | Server error. Retry, and report it if it persists. |

## Request example

POST https://api.sec-api.io/form-s1-424b4

```json
{
  "query": "formType:424B4 AND ticker:RIVN",
  "from": "0",
  "size": "50",
  "sort": [{ "filedAt": { "order": "desc" } }]
}
```

```python
from sec_api import Form_S1_424B4_Api

form_s1_424B4_api = Form_S1_424B4_Api("YOUR_API_KEY")

response = form_s1_424B4_api.get_data({
    "query": "formType:424B4 AND ticker:RIVN",
    "from": "0",
    "size": "50",
    "sort": [{"filedAt": {"order": "desc"}}],
})
```

```javascript
import { formS1424B4Api } from "sec-api";

formS1424B4Api.setApiKey("YOUR_API_KEY");

const response = await formS1424B4Api.getData({
  query: "formType:424B4 AND ticker:RIVN",
  from: "0",
  size: "50",
  sort: [{ filedAt: { order: "desc" } }],
});
```

```bash
curl -X POST https://api.sec-api.io/form-s1-424b4 \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "formType:424B4 AND ticker:RIVN",
    "from": "0",
    "size": "50",
    "sort": [{ "filedAt": { "order": "desc" } }]
  }'
```

## Response example

200 OK · application/json

```json
{
  "total": { "value": 5, "relation": "eq" },
  "data": [
    {
      "id": "f838c5f9775441d7aa3b04e087e0e469",
      "filedAt": "2021-11-12T17:00:47-05:00",
      "accessionNo": "0001193125-21-328239",
      "formType": "424B4",
      "cik": "1874178",
      "ticker": "RIVN",
      "entityName": "Rivian Automotive, Inc. / DE",
      "filingUrl": "https://www.sec.gov/Archives/edgar/data/1874178/000119312521328239/d157488d424b4.htm",
      "tickers": [
        { "ticker": "RIVN", "type": "Class A Common Stock", "exchange": "Nasdaq" }
      ],
      "securities": [
        { "name": "153,000,000 Shares Class A Common Stock" },
        { "name": "Class B common stock" }
      ],
      "publicOfferingPrice": {
        "perShare": 78,
        "perShareText": "$78.0000",
        "total": 11934000000,
        "totalText": "$11,934,000,000"
      },
      "underwritingDiscount": {
        "perShare": 1.1098,
        "perShareText": "$1.1098",
        "total": 169799400,
        "totalText": "$169,799,400"
      },
      "proceedsBeforeExpenses": {
        "perShare": 76.8902,
        "perShareText": "$76.8902",
        "total": 11764200600,
        "totalText": "$11,764,200,600"
      },
      "underwriters": [
        { "name": "Morgan Stanley & Co. LLC" },
        { "name": "Goldman Sachs & Co. LLC" },
        { "name": "J.P. Morgan Securities LLC" },
        { "name": "Barclays Capital Inc." },
        { "name": "Deutsche Bank Securities Inc." }
      ],
      "lawFirms": [
        { "name": "Latham & Watkins LLP", "location": "" },
        { "name": "Skadden, Arps, Slate, Meagher & Flom LLP", "location": "" }
      ],
      "auditors": [{ "name": "KPMG LLP" }],
      "management": [
        {
          "name": "Robert J. Scaringe",
          "age": 38,
          "position": "Founder and Chief Executive Officer, Chairman of the Board of Directors"
        },
        { "name": "Claire McDonough", "age": 40, "position": "Chief Financial Officer" },
        { "name": "Jiten Behl", "age": 39, "position": "Chief Growth Officer" }
      ],
      "employees": {
        "total": 9195,
        "asOfDate": "2021-10-31",
        "perDivision": [],
        "perRegion": []
      }
    }
  ]
}
```