SEC Filings API

https://sec-api.io/docs
Admin
SEC Filings API is a comprehensive platform providing access to EDGAR filings and SEC data through...
Tokens:629,322
Snippets:4,283
Trust Score:7.3
Update:2 months ago
Show doc for...
Tokens:
Raw
### Install and Initialize Subsidiary API

Source: https://sec-api.io/docs/subsidiary-api/python-examples

Install the required package and initialize the API client with your credentials.

```bash
!pip install -q sec-api
```

```python
API_KEY = 'YOUR_API_KEY'

from sec_api import SubsidiaryApi

subsidiary_api = SubsidiaryApi(API_KEY)
```

--------------------------------

### Install Dependencies

Source: https://sec-api.io/docs/insider-ownership-trading-api/python-example

Install the required Python packages for the sec-api SDK and data processing.

```bash
%pip install -q sec-api pandas matplotlib seaborn
```

--------------------------------

### Request Examples

Source: https://sec-api.io/docs/outstanding-shares-float-api

Examples of GET requests using ticker or CIK parameters.

```http
GET https://api.sec-api.io/float?ticker=AAPL
```

```http
GET https://api.sec-api.io/float?cik=1318605
```

--------------------------------

### Output Example

Source: https://sec-api.io/docs/form-c-crowdfunding-api/python-example

Example output for annual offering amounts.

```text
Offering Amount in Form C filings from 2016 to 2024.
```

```text
year  
2016    2.226972e+07  
2017    3.883646e+07  
2018    4.759816e+07  
2019    4.217072e+07  
2020    6.845360e+07  
2021    1.312889e+08  
2022    1.323496e+08  
2023    1.038922e+08  
2024    1.076026e+08  
Name: offeringInformation.offeringAmount, dtype: float64
```

--------------------------------

### N-PORT Filing Output Example

Source: https://sec-api.io/docs/n-port-data-api/python-example

Example output showing the structure of an N-PORT filing overview.

```text
iShares Core S&P 500 ETF (IVV) N-PORT Filing Overview  
-------------------------------------------------  
submissionType                                                   NPORT-P  
accessionNo                                         0001752724-23-039243  
filedAt                                        2023-02-24T13:00:15-05:00  
id                                      88bfb8328b0538f0713310f01f5ff8e9  
filerInfo.filer.issuerCredentials.cik                         0001100663  
filerInfo.filer.issuerCredentials.ccc                           XXXXXXXX  
filerInfo.seriesClassInfo.seriesId                            S000004310  
genInfo.regName                                            iShares Trust  
genInfo.regFileNumber                                          811-09729  
genInfo.regCik                                                0001100663  
genInfo.regLei                                      5493000860OXIC4B5K91  
genInfo.regStreet1                                     400 Howard Street  
genInfo.regCity                                            San Francisco  
genInfo.regStateConditional.regCountry                                US  
genInfo.regStateConditional.regState                               US-CA  
genInfo.regZipOrPostalCode                                         94105  
genInfo.regPhone                                            800-474-2737  
genInfo.seriesName                              iShares Core S&P 500 ETF  
genInfo.seriesId                                              S000004310  
genInfo.seriesLei                                   5493007M4YMN8XL48C14  
genInfo.repPdEnd                                              2023-03-31  
genInfo.repPdDate                                             2022-12-31  
genInfo.isFinalFiling                                                  N  
fundInfo.totAssets                                       293826392297.07  
fundInfo.totLiabs                                          4359714182.67  
fundInfo.netAssets                                        289466678114.4  
fundInfo.assetsAttrMiscSec                                             0  
fundInfo.assetsInvested                                                0  
fundInfo.amtPayOneYrBanksBorr                                          0  
fundInfo.amtPayOneYrCtrldComp                                          0  
fundInfo.amtPayOneYrOthAffil                                           0  
fundInfo.amtPayOneYrOther                                              0
```

--------------------------------

### Install sec-api package

Source: https://sec-api.io/docs/directors-and-board-members-data-api/python-examples

Command to install the required Python library for accessing the API.

```bash
pip install sec-api
```

--------------------------------

### Search Output Example

Source: https://sec-api.io/docs/investment-adviser-and-adv-api/python-example

Example output showing the total matches found.

```text
Total matches found: 1  
Filing  
------  
```

--------------------------------

### Install sec-api Library

Source: https://sec-api.io/docs/aaer-database-api/python-examples

Installs the required package to access the SEC AAER Database API.

```bash
!pip install sec-api  
```

--------------------------------

### GET Response Example

Source: https://sec-api.io/docs/edgar-entities-database-api

Example JSON response structure for an entity lookup.

```json
{
  "id": "1318605",
  "cik": "1318605",
  "cikUpdatedAt": "2005-02-23T11:38:36-05:00",
  "name": "Tesla, Inc.",
  "nameUpdatedAt": "2024-01-26T21:00:20-05:00",
  "businessAddress": {
    "street1": "3500 DEER CREEK RD",
    "street2": null,
    "city": "PALO ALTO",
    "state": "CA",
    "zip": "94304",
    "country": ""
  },
  "businessAddressUpdatedAt": "2018-02-20T21:18:42-05:00",
  "mailingAddress": {
    "street1": "3500 DEER CREEK RD",
    "street2": null,
    "city": "PALO ALTO",
    "state": "CA",
    "zip": "94304",
    "country": ""
  },
  "mailingAddressUpdatedAt": "2018-02-20T21:18:42-05:00",
  "irsNo": "912197729",
  "irsNoUpdatedAt": "2009-04-09T15:30:06-04:00",
  "stateOfIncorporation": "DE",
  "stateOfIncorporationUpdatedAt": "2009-04-09T15:30:06-04:00",
  "phone": "650-681-5000",
  "phoneUpdatedAt": "2010-10-29T12:35:46-04:00",
  "sic": "3711",
  "sicUpdatedAt": "2010-01-29T16:16:56-05:00",
  "sicLabel": "3711 Motor Vehicles & Passenger Car Bodies",
  "sicLabelUpdatedAt": "2024-01-02T16:29:17-05:00",
  "cfOffice": "04 Manufacturing",
  "cfOfficeUpdatedAt": "2024-04-01T18:57:33-04:00",
  "currentReportingStatus": true,
  "currentReportingStatusUpdatedAt": "2024-10-23T20:42:47-04:00",
  "interactiveDataCurrent": true,
  "interactiveDataCurrentUpdatedAt": "2024-10-23T20:42:47-04:00",
  "wellKnownSeasonedIssuer": false,
  "wellKnownSeasonedIssuerUpdatedAt": "2024-04-02T16:47:22-04:00",
  "voluntaryFiler": false,
  "voluntaryFilerUpdatedAt": "2011-08-12T16:41:17-04:00",
  "filerCategory": "Large Accelerated Filer",
  "filerCategoryUpdatedAt": "2012-02-27T17:17:24-05:00",
  "smallBusiness": false,
  "smallBusinessUpdatedAt": "2011-08-12T16:41:17-04:00",
  "emergingGrowthCompany": false,
  "emergingGrowthCompanyUpdatedAt": "2011-08-12T16:41:17-04:00",
  "shellCompany": false,
  "shellCompanyUpdatedAt": "2011-08-12T16:41:17-04:00",
  "fiscalYearEnd": "1231",
  "fiscalYearEndUpdatedAt": "2012-06-08T16:25:18-04:00",
  "latestIcfrAuditFiledAt": "2024-01-26T21:00:20-05:00",
  "latestIcfrAuditFiledAtUpdatedAt": "2024-01-26T21:00:20-05:00",
  "latestIcfrAuditSource": "0001628280-24-002390",
  "latestIcfrAuditSourceUpdatedAt": "2024-01-26T21:00:20-05:00",
  "auditorName": "PricewaterhouseCoopers LLP",
  "auditorNameUpdatedAt": "2022-02-04T20:11:27-05:00",
  "auditorFirmId": "238",
  "auditorFirmIdUpdatedAt": "2022-02-04T20:11:27-05:00",
  "auditorLocation": "San Jose, California"
```

--------------------------------

### Install Dependencies

Source: https://sec-api.io/docs/sec-filings-render-api/python-example

Installs the necessary packages for parallel processing and progress tracking.

```bash
pip install pandarallel ipywidgets
```

--------------------------------

### Output Example

Source: https://sec-api.io/docs/form-144-restricted-sales-api/python-example

Example output string for the top 10 filings report.

```text
Top 10 Form 144 Filings by Proposed Sales Aggregate Value (2022 - 2025).  
```

--------------------------------

### Install SEC API SDK

Source: https://sec-api.io/docs/query-api/node-js-example

Command to install the required Node.js package via npm.

```bash
npm install sec-api
```

--------------------------------

### Console Output Example

Source: https://sec-api.io/docs/investment-adviser-and-adv-api/python-example

Example output showing the number of filings found after applying the filter.

```text
Form ADVs filtered by commodity pool operators  
----------------------------------------------  
Number of Form ADVs found: 3539  
```

--------------------------------

### API Request with Authentication

Source: https://sec-api.io/docs/sec-filings-render-api

Example of a GET request to the beta mirror endpoint including an API key for authentication.

```http
https://edgar-mirror.sec-api.io/Archives/edgar/data/815094/000156459021006205/abmd-8k_20210211.htm?token=YOUR_API_KEY
```

--------------------------------

### Install Required Packages

Source: https://sec-api.io/docs/sec-filings-render-api/python-example

Command to install the necessary libraries for SEC API interaction and parallel processing.

```bash
pip install sec-api pandarallel ipywidgets
```

--------------------------------

### Install Python Dependencies

Source: https://sec-api.io/docs/form-ncen-api-annual-reports-investment-companies/python-example

Install the required data analysis libraries for the notebook environment.

```bash
%pip install -q pandas numpy matplotlib seaborn scipy
```

--------------------------------

### Install WebSocket dependency

Source: https://sec-api.io/docs/stream-api/node-js-example

Run this command in your terminal to install the required WebSocket client library.

```bash
npm install ws
```

--------------------------------

### Sample output string

Source: https://sec-api.io/docs/audit-fees-api/python-example

Example of the text output generated by the script.

```text
Fee by type reported in Form DEF 14A Filings (2002 - 2026)
```

--------------------------------

### Install Legacy Dependencies

Source: https://sec-api.io/docs/stream-api/python-example

Required packages for the legacy streaming client.

```bash
pip install python-engineio==3.14.2 python-socketio[client]==4.6.0
```

--------------------------------

### Install dependencies for data analysis

Source: https://sec-api.io/docs/form-144-restricted-sales-api/python-example

Use this command to install the necessary libraries for data manipulation and visualization.

```bash
# install all dependencies required for the notebook  
# %pip install pandas numpy matplotlib seaborn  
```

--------------------------------

### Install Dependencies

Source: https://sec-api.io/docs/sec-filings-render-api/python-example

Required packages for parallel processing and widget support.

```bash
pip install pandarallel ipywidgets  
```

--------------------------------

### GET Response Example for EDGAR Entities

Source: https://sec-api.io/docs/edgar-entities-database-api

Example response structure for a GET request to the /edgar-entities endpoint filtered by CIK.

```json
          1
          {
        

          2
              "total": {
        

          3
                "value": 1,
        

          4
                "relation": "eq"
        

          5
              },
        

          6
              "data": [
        
```

--------------------------------

### Environment Setup and Imports

Source: https://sec-api.io/docs/form-8k-data-item4-1-search-api/python-example

Initializes the environment with necessary libraries and matplotlib styling for data visualization.

```python
import os  
import json  
import pandas as pd  
import numpy as np  
import matplotlib.pyplot as plt  
import matplotlib.style as style  
import matplotlib.ticker as mtick  
  
style.use("default")  
  
params = {  
	"axes.labelsize": 8, "font.size": 8, "legend.fontsize": 8,  
	"xtick.labelsize": 8, "ytick.labelsize": 8, "font.family": "sans-serif",  
	"axes.spines.top": False, "axes.spines.right": False, "grid.color": "grey",  
	"axes.grid": True, "axes.grid.axis": "y", "grid.alpha": 0.5, "grid.linestyle": ":",  
}  
  
plt.rcParams.update(params)  
```

--------------------------------

### Initialize Query API

Source: https://sec-api.io/docs/query-api/python-example

Setup the QueryApi client with your API key.

```python
from sec_api import QueryApi  
  
queryApi = QueryApi(api_key="YOUR_API_KEY")
```

--------------------------------

### Retrieve entity by CIK via GET

Source: https://sec-api.io/docs/edgar-entities-database-api

Example of a GET request to fetch entity details using a specific CIK.

```http
GET https://api.sec-api.io/edgar-entities?cik=1318605
```

--------------------------------

### Initialize FloatApi

Source: https://sec-api.io/docs/outstanding-shares-float-api/python-example

Set up the API client with your authentication key.

```python
from sec_api import FloatApi  
import pandas as pd  
  
floatApi = FloatApi('YOUR_API_KEY')
```

--------------------------------

### Initialize ExecCompApi

Source: https://sec-api.io/docs/executive-compensation-api/python-example

Import the necessary modules and initialize the API client with your API key.

```python
from sec_api import ExecCompApi  
import pandas as pd  
  
execCompApi = ExecCompApi("YOUR_API_KEY")
```

--------------------------------

### Retrieve NASDAQ Company List

Source: https://sec-api.io/docs/mapping-api/list-companies-by-exchange

Example response structure for a GET request to the NASDAQ exchange endpoint.

```json
[
        {
            "name": "Aaon Inc",
            "ticker": "AAON",
            "cik": "824142",
            "cusip": "000360206",
            "exchange": "NASDAQ",
            "isDelisted": false,
            "category": "Domestic Common Stock",
            "sector": "Basic Materials",
            "industry": "Building Products & Equipment",
            "sic": "3585",
            "sicSector": "Manufacturing",
            "sicIndustry": "Air-Cond & Warm Air Heatg Equip & Comm & Indl Refrig Equip",
            "famaSector": "",
            "famaIndustry": "Machinery",
            "currency": "USD",
            "location": "Oklahoma; U.S.A",
            "id": "7414f59fa8ea1454fe8f18f54ee80a9e"
        },
        {
            "name": "Admiralty Bancorp Inc",
            "ticker": "AAAB",
            "cik": "1066808",
            "cusip": "007231103",
            "exchange": "NASDAQ",
            "isDelisted": true,
            "category": "Domestic Common Stock",
            "sector": "Financial Services",
            "industry": "Banks - Regional",
            "sic": "6022",
            "sicSector": "Finance Insurance And Real Estate",
            "sicIndustry": "State Commercial Banks",
            "famaSector": "",
            "famaIndustry": "Banking",
            "currency": "USD",
            "location": "Florida; U.S.A",
            "id": "28db077d51302cd02d0e400086d94b3f"
        },
        {
            "name": "Advanced Accelerator Applications SA",
            "ticker": "AAAP",
            "cik": "1611787",
            "cusip": "00790T100",
            "exchange": "NASDAQ",
            "isDelisted": true,
            "category": "ADR Common Stock",
            "sector": "Healthcare",
            "industry": "Biotechnology",
            "sic": "2834",
            "sicSector": "Manufacturing",
            "sicIndustry": "Pharmaceutical Preparations",
            "famaSector": "",
            "famaIndustry": "Pharmaceutical Products",
            "currency": "EUR",
            "location": "France",
            "id": "5971a249eeac5dc6a31314e014dd4ff1"
        }
        // ... more results
    ]
```

--------------------------------

### Example output for 10b5-1 query

Source: https://sec-api.io/docs/insider-ownership-trading-api/python-example

Sample console output showing transaction counts and the flagged share percentage.

```text
NVDA unfiltered transactions: 307  
NVDA filings whose footnotes reference 10b5-1: 503  
Share of unfiltered transactions flagged as 10b5-1: 85.3%
```

--------------------------------

### Initialize RenderApi and Pandarallel

Source: https://sec-api.io/docs/sec-filings-render-api/python-example

Setup the RenderApi client and initialize the parallel processing environment.

```python
import os  
from pandarallel import pandarallel  
from sec_api import RenderApi  
  
pandarallel.initialize(nb_workers=4, progress_bar=True)  
  
renderApi = RenderApi(SEC_API_KEY)  
```

--------------------------------

### Download Audit Report Request

Source: https://sec-api.io/docs/audit-reports-database-api

Example of a GET request to retrieve a specific ICFR audit report using its unique ID and an API key.

```http
https://api.sec-api.io/audit-reports/content/6aef77ab8ad107b100be0440fe9dd004?token=YOUR_API_KEY
```

--------------------------------

### Initialize Analysis Environment

Source: https://sec-api.io/docs/aaer-database-api/python-examples

Sets up the necessary libraries and matplotlib parameters for data visualization.

```python
import os  
import pandas as pd  
import numpy as np  
import matplotlib.pyplot as plt  
import matplotlib.style as style  
import json  
  
style.use("default")  
  
params = {  
	"axes.labelsize": 8, "font.size": 8, "legend.fontsize": 8,  
	"xtick.labelsize": 8, "ytick.labelsize": 8, "font.family": "sans-serif",  
	"axes.spines.top": False, "axes.spines.right": False, "grid.color": "grey",  
	"axes.grid": True, "axes.grid.axis": "y", "grid.alpha": 0.5, "grid.linestyle": ":",  
}  
  
plt.rcParams.update(params)  
```

--------------------------------

### Installing Pandarallel

Source: https://sec-api.io/docs/investment-adviser-and-adv-api/python-example

Installs the pandarallel library for parallel processing in pandas.

```bash
!pip install -q pandarallel
```

--------------------------------

### Initialize API credentials

Source: https://sec-api.io/docs/form-13-f-filings-institutional-holdings-api/python-example

Import necessary libraries and set the API key variable.

```python
import json
import pandas as pd

API_KEY_SEC_API = "YOUR_API_KEY"
```

--------------------------------

### Initialize API and Query Data

Source: https://sec-api.io/docs/form-s1-424b4-data-search-api/python-examples

Initialize the API client with your key and execute a search query for specific filings.

```python
from sec_api import Form_S1_424B4_Api

form_s1_424B4_api = Form_S1_424B4_Api("YOUR_API_KEY")

query = {
    "query": "ticker:V",
    "from": "0",
    "size": "50",
    "sort": [{"filedAt": {"order": "desc"}}],
}

response = form_s1_424B4_api.get_data(query)
```

--------------------------------

### Install Dependencies

Source: https://sec-api.io/docs/audit-fees-api/python-example

Installs the necessary Python libraries for data manipulation and visualization.

```python
# install all dependencies required for the notebook  
%pip install -q pandas numpy matplotlib seaborn scipy  
```

--------------------------------

### Brochure Search Response Example

Source: https://sec-api.io/docs/investment-adviser-and-adv-api

Example response structure for a brochure search query.

```json
{
	"brochures": [
		{
			"versionId": 795951,
			"name": "SELECT UMA PROGRAM BROCHURE"
		}
```

--------------------------------

### Initialize API Client

Source: https://sec-api.io/docs/form-13d-13g-search-api/python-examples

Import necessary libraries and configure the Form13DGApi client with your API key.

```python
from sec_api import Form13DGApi  
import pandas as pd  
import json  
import matplotlib.pyplot as plt  
  
pd.options.display.float_format = lambda v: f"{v:,.2f}"  
pd.options.display.max_columns = 50  
pd.options.display.width = 200  
  
API_KEY = "YOUR_API_KEY"  
form13DGApi = Form13DGApi(API_KEY)  
```

--------------------------------

### Initialize FormNportApi and Execute Search

Source: https://sec-api.io/docs/n-port-data-api/python-example

Initialize the API client with your key and perform a search query for N-PORT filings. The response contains a list of filings matching the criteria.

```python
from sec_api import FormNportApi  
  
nportApi = FormNportApi("YOUR_API_KEY")  
  
search_query = {  
	"query": "fundInfo.totAssets:[100000000 TO *]",  
	"from": "0",  
	"size": "10",  
	"sort": [{"filedAt": {"order": "desc"}}],  
}  
  
response = nportApi.get_data(search_query)  
  
response["filings"][0]
```

--------------------------------

### Initialize RenderApi client

Source: https://sec-api.io/docs/sec-filings-render-api/python-example

Import the necessary modules and initialize the RenderApi client with your API key.

```python
import re
from sec_api import RenderApi

renderApi = RenderApi("YOUR_API_KEY")
```

--------------------------------

### API Response Example

Source: https://sec-api.io/docs/form-13d-13g-search-api/python-examples

Example output structure returned by the API for a 13D filing query.

```json
Total matching filings: {'value': 10000, 'relation': 'gte'}  
Filings returned: 50  
  
First filing (sample):  
{  
	"id": "8237e891c3308cd3ae3ec74553516edf",  
	"accessionNo": "0000950103-26-005722",  
	"formType": "SC 13D/A",  
	"filedAt": "2026-04-15T06:19:05-04:00",  
	"filers": [  
		{  
			"cik": "1014763",  
			"name": "Ainos, Inc. (Subject)"  
		},  
		{  
			"cik": "1122411",  
			"name": "ASE Technology Holding Co., Ltd. (Filed by)"  
		}  
	],  
	"nameOfIssuer": "Ainos, Inc.",  
	"titleOfSecurities": "Common Stock, par value $0.01 per share",  
	"cusip": [],  
	"eventDate": "2026-04-12",  
	"amendmentNo": "2",  
	"schedule13GFiledPreviously": false,  
	"owners": [  
		{  
			"name": [  
				"ASE Technology Holding Co., Ltd."  
			],  
			"memberOfGroup": {  
				"a": false,  
				"b": false  
			},  
			"sourceOfFunds": "WC",  
			"legalProceedingsDisclosureRequired": false,  
			"place": "F5",  
			"soleVotingPower": 0,  
			"sharedVotingPower": 667085,  
			"soleDispositivePower": 0,  
			"sharedDispositivePower": 667085,  
			"aggregateAmountOwned": 667085,  
			"isAggregateExcludeShares": false,  
			"amountAsPercent": 8.4,  
			"typeOfReportingPerson": [  
				"CO"  
			]  
		},  
		{  
			"name": [  
				"ASE Test, Inc."  
			],  
			"memberOfGroup": {  
				"a": false,  
				"b": false  
			},  
			"sourceOfFunds": "WC",  
			"legalProceedingsDisclosureRequired": false,  
			"place": "F5",  
			"soleVotingPower": 0,  
			"sharedVotingPower": 667085,  
			"soleDispositivePower": 0,  
			"sharedDispositivePower": 667085,  
			"aggregateAmountOwned": 667085,  
			"isAggregateExcludeShares": false,  
			"amountAsPercent": 8.4,  
			"typeOfReportingPerson": [  
				"CO"  
			]  
		}  
	],  
	"item1": {  
		"securityTitle": "Common Stock, par value $0.01 per share",  
		"issuerName": "Ainos, Inc.",  
		"issuerPrincipalAddress": {  
			"street1": "3050 POST OAK BLVD,",  
			"street2": "SUITE 510-T80",  
			"city": "Houston",  
			"stateOrCountry": "TX",  
			"zipCode": "77056"  
		},  
```

--------------------------------

### XSD URL Output Preview

Source: https://sec-api.io/docs/query-api/python-example

Example output showing the count of XSD URLs retrieved.

```text
Number of XSD File URLs:  
 120  
First 5 XSD File URLs:  
```

--------------------------------

### Initialize Query API Client

Source: https://sec-api.io/docs/query-api/python-example

Import the necessary modules and initialize the QueryApi client with your API key.

```python
from sec_api import QueryApi
import pandas as pd

queryApi = QueryApi(api_key="YOUR_API_KEY")
```

--------------------------------

### Descriptive statistics output example

Source: https://sec-api.io/docs/form-c-crowdfunding-api/python-example

Example output string indicating the date range for descriptive statistics.

```text
Descriptive statistics for Form C counts by month from 2016 to 2024.  
```

--------------------------------

### Initialize API Client

Source: https://sec-api.io/docs/insider-ownership-trading-api/python-example

Import necessary libraries and initialize the InsiderTradingApi client with your API key.

```python
import json
from collections import defaultdict

import numpy as np
import pandas as pd
import matplotlib.pyplot as plt
import seaborn as sns

from sec_api import InsiderTradingApi

# Get your API key at https://sec-api.io
API_KEY = "YOUR_API_KEY"

insider_api = InsiderTradingApi(api_key=API_KEY)

sns.set_theme(style="whitegrid")
# Human-readable pandas display (no scientific notation)
pd.options.display.float_format = lambda v: f"{v:,.2f}"
pd.options.display.max_columns = 50
pd.options.display.width = 200
```

--------------------------------

### AAER Data Field Examples

Source: https://sec-api.io/docs/aaer-database-api

Examples of various data fields used in the AAER database API.

```json
['33-11219', '34-98065', 'IA-6323]
```

```json
2025-01-29T12:56:13-05:00
```

```json
[{"name":"Jason M. Boucher, CPA","type":"individual"}]
```

```json
["fraud", "misrepresentation"]
```

```json
1090727
```

```json
UPS
```

```json
["UPS failed to adhere to the basic accounting principle of fair value, resulting in material misrepresentations to investors regarding its earnings and other reported items."]
```

```json
["Tokyo District Court"]
```

```json
["disgorgement", "cease and desist order"]
```

```json
["Section 30A of the Exchange Act", "Section 13(b)(2)(A) of the Exchange Act"]
```

--------------------------------

### Example output of data loading

Source: https://sec-api.io/docs/reg-a-offering-statements-api/python-example

Displays the expected console output after running the data loading script.

```text
Loaded dataframe with main documents of Regulation A Offering Statement filings  
Number of filings: 11,411  
Number of records: 11,411  
Number of years: 11 (2015-2025)  
Number of unique companies: 1,696  
```

--------------------------------

### Form 5 JSONL Data Example

Source: https://sec-api.io/docs/insider-ownership-trading-api

Example of a single record from the decompressed JSONL file for Form 5 filings.

```json
{"id":"06d31397a5aa533faf912fe6ee249c80","accessionNo":"0001641172-25-001401","filedAt":"2025-03-28T20:23:39-04:00","schemaVersion":"X0508","documentType":"5","periodOfReport":"2025-02-28","notSubjectToSection16":false,"issuer":{"cik":"788611","name":"NextTrip, Inc.","tradingSymbol":"NTRP"},"reportingOwner":{"cik":"1563607","name":"Monaco Donald P","address":{"street1":"3900 PASEO DEL SOL","city":"SANTA FE","state":"NM","zipCode":"87507"},"relationship":{"isDirector":true,"isOfficer":false,"isTenPercentOwner":false,"isOther":false}},"derivativeTable":{"transactions":[{"securityTitle":"Series L Nonvoting Convertible Preferred Stock","conversionOrExercisePriceFootnoteId":["F1"],"transactionDate":"2024-12-31","coding":{"formType":"4","code":"A","equitySwapInvolved":false,"footnoteId":["F2"]},"timeliness":"L","exerciseDateFootnoteId":["F1"],"expirationDateFootnoteId":["F3"],"underlyingSecurity":{"title":"Common Stock","shares":413907},"amounts":{"shares":413907,"pricePerShare":3.02,"pricePerShareFootnoteId":["F2"],"acquiredDisposedCode":"A"},"postTransactionAmounts":{"sharesOwnedFollowingTransaction":745032},"ownershipNature":{"directOrIndirectOwnership":"I","natureOfOwnership":"By Donald P. Monaco Insurance Trust","natureOfOwnershipFootnoteId":["F4"]}},{"securityTitle":"Series L Nonvoting Convertible Preferred Stock","conversionOrExercisePriceFootnoteId":["F1"],"transactionDate":"2025-02-24","coding":{"formType":"4","code":"A","equitySwapInvolved":false,"footnoteId":["F5"]},"timeliness":"L","exerciseDateFootnoteId":["F1"],"expirationDateFootnoteId":["F3"],"underlyingSecurity":{"title":"Common Stock","shares":331125},"amounts":{"shares":331125,"pricePerShare":3.02,"pricePerShareFootnoteId":["F5"],"acquiredDisposedCode":"A"},"postTransactionAmounts":{"sharesOwnedFollowingTransaction":745032},"ownershipNature":{"directOrIndirectOwnership":"I","natureOfOwnership":"By Donald P. Monaco Insurance Trust","natureOfOwnershipFootnoteId":["F4"]}}]},"footnotes":[{"id":"F1","text":"Shares of Series L Nonvoting Convertible Preferred Stock (Series L Preferred) shall not be convertible into shares of common stock unless and until stockholder approval of the conversion of the Series L Preferred into common stock (\"Stockholder Approval\") is obtained. Following receipt of Stockholder Approval, each share of Series L Preferred will automatically convert into one share of common stock, subject to certain limitations."},{"id":"F2","text":"On December 31, 2024, the Issuer and the Reporting Person entered into a debt conversion agreement, pursuant to which $1.25 million in existing promissory notes owed to the Reporting Person for monies advanced to the Issuer were converted into 413,907 shares of Series L Preferred at a price of $3.02 per share. The debt conversion agreement and the conversion of the promissory notes into shares of Series L Preferred were approved in advance by the Issuer's board of directors."},{"id":"F3","text":"The shares of Series L Preferred do not expire."},{"id":"F4","text":"The shares of Series L Preferred are beneficially owned by the Donald P. Monaco Insurance Trust (the \"Trust\"). Mr. Monaco, is the trustee of the Trust. As such, Mr. Monaco is deemed to beneficially own the shares held by the Trust. Mr. Monaco disclaims beneficial ownership of all securities held the Trust in excess of his pecuniary interest, if any, and this report shall not be deemed an admission that he is the beneficial owner of, or has pecuniary interest in, any such excess shares for the purposes of Section 16 of the Securities Exchange Act of 1934, as amended, or for any other purpose."},{"id":"F5","text":"On February 24, 2025, the Issuer and the Reporting Person entered into a debt conversion agreement, pursuant to which $1.00 million in existing promissory notes owed to the Reporting Person for monies advanced to the Issuer were converted into 331,125 shares of Series L Preferred at a price of $3.02 per share. The debt conversion agreement and the conversion of the promissory notes into shares of Series L Preferred were approved in advance by the Issuer's board of directors."}],"ownerSignatureName":"/s/ Donald P. Monaco","ownerSignatureNameDate":"2025-03-28"}
```

```json
{ ... }
```

--------------------------------

### Form N-CEN JSONL Decompressed Example

Source: https://sec-api.io/docs/form-ncen-api-annual-reports-investment-companies

Example of a single record within a decompressed JSONL file for Form N-CEN.

```json
{"formType":"N-CEN","seriesClass": "{...}","generalInfo": "{...}","registrantInfo": "{...}","managementInvestmentQuestionSeriesInfo": "{...}","attachmentsTab": "{...}","signature": "{...}","accessionNo":"0001752724-25-025892","filedAt":"2025-04-01T17:30:54-04:00","id":"201ccfd8ed1911b9b3ac93a74db53d23"}
```

--------------------------------

### Console Output

Source: https://sec-api.io/docs/sec-filings-render-api/python-example

Example log output showing the progress of fetching filings for specific ticker batches.

```text
Fetching filings for ['SLB', 'REGN', 'VRTX', 'BDX']...  
Fetching filings for ['AAPL', 'MSFT', 'AMZN', 'BRKB']...
```

--------------------------------

### Mapping API Response Example

Source: https://sec-api.io/docs/mapping-api

Example JSON response structure returned by the mapping endpoint for a specific ticker query.

```json
[
    {
        "name": "Tesla Inc",
        "ticker": "TSLA",
        "cik": "1318605",
        "cusip": "88160R101",
        "exchange": "NASDAQ",
        "isDelisted": false,
        "category": "Domestic Common Stock",
        "sector": "Consumer Cyclical",
        "industry": "Auto Manufacturers",
        "sic": "3711",
        "sicSector": "Manufacturing",
        "sicIndustry": "Motor Vehicles & Passenger Car Bodies",
        "famaSector": "",
        "famaIndustry": "Automobiles and Trucks",
        "currency": "USD",
        "location": "California; U.S.A",
        "id": "e27d6e9606f216c569e46abf407685f3"
    }
]
```

--------------------------------

### Form 13F JSON Response Example

Source: https://sec-api.io/docs/form-13-f-filings-institutional-holdings-api/python-example

Example of the JSON structure returned by the Form 13F cover page API.

```json
{
  "id": "d1a4cbcd2eab004e9415e402a2701c46",
  "accessionNo": "0001172661-24-002257",
  "filedAt": "2024-05-14T12:37:20-04:00",
  "formType": "13F-HR",
  "cik": "1350694",
  "crdNumber": "105129",
  "secFileNumber": "801-35875",
  "form13FFileNumber": "028-11794",
  "periodOfReport": "2024-03-31",
  "isAmendment": false,
  "amendmentInfo": {},
  "filingManager": {
    "name": "Bridgewater Associates, LP",
    "address": {
      "street": "One Nyala Farms Road",
      "city": "Westport",
      "stateOrCountry": "CT",
      "zipCode": 6880
    }
  },
  "reportType": "13F HOLDINGS REPORT",
  "otherManagersReportingForThisManager": [],
  "provideInfoForInstruction5": false,
  "signature": {
    "name": "Michael Kitson",
    "title": "Chief Compliance Officer and Counsel",
    "phone": "203-226-3030",
    "signature": "Michael Kitson",
    "city": "Westport",
    "stateOrCountry": "CT",
    "signatureDate": "05-14-2024"
  },
  "tableEntryTotal": 677,
  "tableEntryTotalAsReported": 677,
  "tableValueTotal": 19775432137,
  "tableValueTotalAsReported": 19775432137,
  "otherIncludedManagersCount": 0,
  "otherIncludedManagers": []
}
```

--------------------------------

### Console Output Example

Source: https://sec-api.io/docs/form-s1-424b4-data-search-api/python-examples

Expected console output when running the data fetching function.

```text
✅ 2023-01 with 22 filings  
✅ 2023-02 with 39 filings  
✅ 2023-03 with 34 filings  
✅ 2023-04 with 32 filings  
✅ 2023-05 with 33 filings  
✅ 2023-06 with 48 filings  
✅ 2023-07 with 30 filings  
✅ 2023-08 with 36 filings  
✅ 2023-09 with 34 filings  
✅ 2023-10 with 35 filings  
✅ 2023-11 with 40 filings  
✅ 2023-12 with 27 filings  
✅ 2023 with 410 filings
```

--------------------------------

### N-PORT Filing Data Structure Example

Source: https://sec-api.io/docs/n-port-data-api/python-example

Example of the JSON object structure representing a list of holdings within an N-PORT filing.

```json
  'isLoanByFund': 'N'}},  
  {'name': 'SEACOAST BANKING CORP/FL',  
   'lei': '549300V6IC06XYQYPG88',  
   'title': 'COMMON STOCK USD.1',  
   'cusip': '811707801',  
   'identifiers': {'isin': {'value': 'US8117078019'},  
    'ticker': {'value': 'SBCF'},  
    'other': {'otherDesc': 'SEDOL Number', 'value': 'BH65L93'}},  
   'balance': 63288,  
   'units': 'NS',  
   'curCd': 'USD',  
   'valUSD': 1913196.24,  
   'pctVal': 0.363323542577,  
   'payoffProfile': 'Long',  
   'assetCat': 'EC',  
   'issuerCat': 'CORP',  
   'invCountry': 'US',  
   'isRestrictedSec': 'N',  
   'fairValLevel': '1',  
   'securityLending': {'isCashCollateral': 'N',  
    'isNonCashCollateral': 'N',  
    'isLoanByFund': 'N'}},  
  {'name': 'SELECTIVE INSURANCE GROUP',  
   'lei': '549300R3WGJWLE40R258',  
   'title': 'COMMON STOCK USD2.0',  
   'cusip': '816300107',  
   'identifiers': {'isin': {'value': 'US8163001071'},  
    'ticker': {'value': 'SIGI'},  
    'other': {'otherDesc': 'SEDOL Number', 'value': '2766173'}},  
   'balance': 19808,  
   'units': 'NS',  
   'curCd': 'USD',  
   'valUSD': 1612371.2,  
   'pctVal': 0.30619567616,  
   'payoffProfile': 'Long',  
   'assetCat': 'EC',  
   'issuerCat': 'CORP',  
   'invCountry': 'US',  
   'isRestrictedSec': 'N',  
   'fairValLevel': '1',  
   'securityLending': {'isCashCollateral': 'N',  
    'isNonCashCollateral': 'N',  
    'isLoanByFund': 'N'}},  
  {'name': 'SHOCKWAVE MEDICAL INC',  
   'lei': '549300LDXO56IC5Y1538',  
   'title': 'COMMON STOCK USD.001',  
   'cusip': '82489T104',  
   'identifiers': {'isin': {'value': 'US82489T1043'},  
    'ticker': {'value': 'SWAV'},  
    'other': {'otherDesc': 'SEDOL Number', 'value': 'BHLNZ89'}},  
   'balance': 18228,  
   'units': 'NS',  
   'curCd': 'USD',  
   'valUSD': 5068659.96,  
   'pctVal': 0.962558599209,  
   'payoffProfile': 'Long',  
   'assetCat': 'EC',  
   'issuerCat': 'CORP',  
   'invCountry': 'US',  
   'isRestrictedSec': 'N',  
   'fairValLevel': '1',  
   'securityLending': {'isCashCollateral': 'N',  
    'isNonCashCollateral': 'N',  
    'isLoanByFund': 'N'}},  
  {'name': 'SKYLINE CHAMPION CORP',  
   'lei': 'N/A',  
   'title': 'COMMON STOCK USD.028',  
   'cusip': '830830105',  
   'identifiers': {'isin': {'value': 'US8308301055'},  
    'ticker': {'value': 'SKY'},  
    'other': {'otherDesc': 'SEDOL Number', 'value': '2814005'}},  
   'balance': 67750,  
   'units': 'NS',  
   'curCd': 'USD',  
   'valUSD': 3581942.5,  
   'pctVal': 0.680225065886,  
   'payoffProfile': 'Long',  
   'assetCat': 'EC',  
   'issuerCat': 'CORP',  
   'invCountry': 'US',  
   'isRestrictedSec': 'N',  
   'fairValLevel': '1',  
   'securityLending': {'isCashCollateral': 'N',  
    'isNonCashCollateral': 'N',  
    'isLoanByFund': 'N'}},  
  {'name': 'SM ENERGY CO',  
   'lei': '84BUTVXV5ODI6BXNMH43',  
   'title': 'COMMON STOCK USD.01',  
   'cusip': '78454L100',  
   'identifiers': {'isin': {'value': 'US78454L1008'},  
    'ticker': {'value': 'SM'},  
    'other': {'otherDesc': 'SEDOL Number', 'value': '2764188'}},  
   'balance': 141489,  
   'units': 'NS',  
   'curCd': 'USD',  
   'valUSD': 5321401.29,  
   'pctVal': 1.010555178677,  
   'payoffProfile': 'Long',  
   'assetCat': 'EC',  
   'issuerCat': 'CORP',  
   'invCountry': 'US',  
   'isRestrictedSec': 'N',  
   'fairValLevel': '1',  
   'securityLending': {'isCashCollateral': 'N',  
    'isNonCashCollateral': 'N',  
    'isLoanByFund': 'N'}},  
  {'name': 'SOVOS BRANDS INC',  
   'lei': 'N/A',  
   'title': 'COMMON STOCK USD.001',  
   'cusip': '84612U107',  
   'identifiers': {'isin': {'value': 'US84612U1079'},  
    'ticker': {'value': 'SOVO'},  
    'other': {'otherDesc': 'SEDOL Number', 'value': 'BNZJHZ6'}},  
   'balance': 134880,  
   'units': 'NS',  
   'curCd': 'USD',  
   'valUSD': 1920691.2,  
   'pctVal': 0.364746865162,  
   'payoffProfile': 'Long',  
   'assetCat': 'EC',  
   'issuerCat': 'CORP',  
   'invCountry': 'US',  
   'isRestrictedSec': 'N',  
   'fairValLevel': '1',  
   'securityLending': {'isCashCollateral': 'N',  
    'isNonCashCollateral': 'N',  
    'isLoanByFund': 'N'}},  
  {'name': 'SPIRIT AEROSYSTEMS HOLD CL A',  
   'lei': 'ZD2NBKV6GCC3UMGBM518',  
   'title': 'COMMON STOCK USD.01',  
   'cusip': '848574109',  
   'identifiers': {'isin': {'value': 'US8485741099'},  
    'ticker': {'value': 'SPR'},  
    'other': {'otherDesc': 'SEDOL Number', 'value': 'B1HMMS7'}},  
   'balance': 56640,  
   'units': 'NS',  
   'curCd': 'USD',  
   'valUSD': 1241548.8,  
   'pctVal': 0.235775033876,  
   'payoffProfile': 'Long',  
   'assetCat': 'EC',  
   'issuerCat': 'CORP',  
   'invCountry': 'US',  
   'isRestrictedSec': 'N',  
   'fairValLevel': '1',  
   'securityLending': {'isCashCollateral': 'N',  
    'isNonCashCollateral': 'N',  
    'isLoanByFund': 'N'}},  
  {'name': 'SPROUT SOCIAL INC   CLASS A',  
   'lei': 'N/A',  
   'title': 'COMMON STOCK USD.0001',  
```
Tokens:
Raw