SEC Filings API
Overview
To use SEC Filings, you need an API key. You can get one by creating a free account and visiting your dashboard.
GET Endpoint
https://api.apiverve.com/v1/secfilingsExample
How to call the SEC Filings API in different programming languages.
curl -X GET \
"https://api.apiverve.com/v1/secfilings?ticker=AAPL&form=10-K&limit=10" \
-H "X-API-Key: your_api_key_here"const response = await fetch('https://api.apiverve.com/v1/secfilings?ticker=AAPL&form=10-K&limit=10', {
method: 'GET',
headers: {
'X-API-Key': 'your_api_key_here',
'Content-Type': 'application/json'
}
});
const data = await response.json();
console.log(data);import requests
headers = {
'X-API-Key': 'your_api_key_here',
'Content-Type': 'application/json'
}
response = requests.get('https://api.apiverve.com/v1/secfilings?ticker=AAPL&form=10-K&limit=10', headers=headers)
data = response.json()
print(data)package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.apiverve.com/v1/secfilings?ticker=AAPL&form=10-K&limit=10", nil)
req.Header.Set("X-API-Key", "your_api_key_here")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}{
"status": "ok",
"error": null,
"data": {
"ticker": "AAPL",
"cik": "0000320193",
"company": "Apple Inc.",
"sic": "3571",
"sicDescription": "Electronic Computers",
"fiscalYearEnd": "0927",
"totalRecentFilings": 1000,
"count": 4,
"latest": {
"annual": {
"form": "10-K",
"filingDate": "2025-11-01",
"accessionNumber": "0000320193-25-000123",
"primaryDocument": "aapl-20250927.htm",
"url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000123/aapl-20250927.htm",
"daysAgo": 62
},
"quarterly": {
"form": "10-Q",
"filingDate": "2025-08-01",
"accessionNumber": "0000320193-25-000106",
"primaryDocument": "aapl-20250628.htm",
"url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000106/aapl-20250628.htm",
"daysAgo": 154
},
"currentReport": {
"form": "8-K",
"filingDate": "2025-10-30",
"accessionNumber": "0000320193-25-000121",
"primaryDocument": "aapl-20251030.htm",
"url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000121/aapl-20251030.htm",
"daysAgo": 64
}
},
"filings": [
{
"form": "10-K",
"filingDate": "2025-11-01",
"reportDate": "2025-09-27",
"primaryDocDescription": "10-K",
"accessionNumber": "0000320193-25-000123",
"primaryDocument": "aapl-20250927.htm",
"url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000123/aapl-20250927.htm",
"items": null,
"isXBRL": true
},
{
"form": "8-K",
"filingDate": "2025-10-30",
"reportDate": "2025-10-30",
"primaryDocDescription": "8-K",
"accessionNumber": "0000320193-25-000121",
"primaryDocument": "aapl-20251030.htm",
"url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000121/aapl-20251030.htm",
"items": "2.02,9.01",
"isXBRL": true
},
{
"form": "4",
"filingDate": "2025-10-16",
"reportDate": "2025-10-14",
"primaryDocDescription": "FORM 4",
"accessionNumber": "0000320193-25-000118",
"primaryDocument": "xslF345X05/wf-form4.xml",
"url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000118/xslF345X05/wf-form4.xml",
"items": null,
"isXBRL": false
},
{
"form": "10-Q",
"filingDate": "2025-08-01",
"reportDate": "2025-06-28",
"primaryDocDescription": "10-Q",
"accessionNumber": "0000320193-25-000106",
"primaryDocument": "aapl-20250628.htm",
"url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000106/aapl-20250628.htm",
"items": null,
"isXBRL": true
}
],
"analytics": {
"formCounts": {
"3": 22,
"4": 512,
"8-K": 96,
"10-Q": 84,
"10-K": 28,
"DEF 14A": 27,
"SC 13G": 41
},
"filingsLast30Days": 3,
"filingsLast90Days": 9,
"filingsLast365Days": 74,
"daysSinceLastFiling": 62,
"daysSinceLastAnnual": 62,
"daysSinceLastQuarterly": 154,
"averageDaysBetweenFilings": 12.4,
"mostActiveForm": "4"
}
}
}Authentication
The SEC Filings API requires authentication via API key. Include your API key in the request header:
X-API-Key: your_api_key_hereInteractive API Playground
Test the SEC Filings API directly in your browser with live requests and responses.
Parameters
The following parameters are available for the SEC Filings API:
Get SEC Filings by Ticker
| Parameter | Type | Required | Description | Default | Example |
|---|---|---|---|---|---|
ticker | string | required | Stock ticker symbol (e.g. AAPL, MSFT, ADBE) Length: 1 - 6 chars | - | |
formPremium | string | optional | Filter to a single form type (e.g. 10-K, 10-Q, 8-K, 4). | - | |
limitPremium | integer | optional | Number of filings to return (1-50). Defaults to 5. Range: 1 - 50 | - |
Response
The SEC Filings API returns responses in JSON, XML, YAML, and CSV formats. The JSON response is shown in the Example section above; alternative formats below.
Other Response Formats
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>ok</status>
<error xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<data>
<ticker>AAPL</ticker>
<cik>0000320193</cik>
<company>Apple Inc.</company>
<sic>3571</sic>
<sicDescription>Electronic Computers</sicDescription>
<fiscalYearEnd>0927</fiscalYearEnd>
<totalRecentFilings>1000</totalRecentFilings>
<count>4</count>
<latest>
<annual>
<form>10-K</form>
<filingDate>2025-11-01</filingDate>
<accessionNumber>0000320193-25-000123</accessionNumber>
<primaryDocument>aapl-20250927.htm</primaryDocument>
<url>https://www.sec.gov/Archives/edgar/data/320193/000032019325000123/aapl-20250927.htm</url>
<daysAgo>62</daysAgo>
</annual>
<quarterly>
<form>10-Q</form>
<filingDate>2025-08-01</filingDate>
<accessionNumber>0000320193-25-000106</accessionNumber>
<primaryDocument>aapl-20250628.htm</primaryDocument>
<url>https://www.sec.gov/Archives/edgar/data/320193/000032019325000106/aapl-20250628.htm</url>
<daysAgo>154</daysAgo>
</quarterly>
<currentReport>
<form>8-K</form>
<filingDate>2025-10-30</filingDate>
<accessionNumber>0000320193-25-000121</accessionNumber>
<primaryDocument>aapl-20251030.htm</primaryDocument>
<url>https://www.sec.gov/Archives/edgar/data/320193/000032019325000121/aapl-20251030.htm</url>
<daysAgo>64</daysAgo>
</currentReport>
</latest>
<filings>
<filing>
<form>10-K</form>
<filingDate>2025-11-01</filingDate>
<reportDate>2025-09-27</reportDate>
<primaryDocDescription>10-K</primaryDocDescription>
<accessionNumber>0000320193-25-000123</accessionNumber>
<primaryDocument>aapl-20250927.htm</primaryDocument>
<url>https://www.sec.gov/Archives/edgar/data/320193/000032019325000123/aapl-20250927.htm</url>
<items xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<isXBRL>true</isXBRL>
</filing>
<filing>
<form>8-K</form>
<filingDate>2025-10-30</filingDate>
<reportDate>2025-10-30</reportDate>
<primaryDocDescription>8-K</primaryDocDescription>
<accessionNumber>0000320193-25-000121</accessionNumber>
<primaryDocument>aapl-20251030.htm</primaryDocument>
<url>https://www.sec.gov/Archives/edgar/data/320193/000032019325000121/aapl-20251030.htm</url>
<items>2.02,9.01</items>
<isXBRL>true</isXBRL>
</filing>
<filing>
<form>4</form>
<filingDate>2025-10-16</filingDate>
<reportDate>2025-10-14</reportDate>
<primaryDocDescription>FORM 4</primaryDocDescription>
<accessionNumber>0000320193-25-000118</accessionNumber>
<primaryDocument>xslF345X05/wf-form4.xml</primaryDocument>
<url>https://www.sec.gov/Archives/edgar/data/320193/000032019325000118/xslF345X05/wf-form4.xml</url>
<items xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<isXBRL>false</isXBRL>
</filing>
<filing>
<form>10-Q</form>
<filingDate>2025-08-01</filingDate>
<reportDate>2025-06-28</reportDate>
<primaryDocDescription>10-Q</primaryDocDescription>
<accessionNumber>0000320193-25-000106</accessionNumber>
<primaryDocument>aapl-20250628.htm</primaryDocument>
<url>https://www.sec.gov/Archives/edgar/data/320193/000032019325000106/aapl-20250628.htm</url>
<items xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<isXBRL>true</isXBRL>
</filing>
</filings>
<analytics>
<formCounts>
<3>22</3>
<4>512</4>
<8_K>96</8_K>
<10_Q>84</10_Q>
<10_K>28</10_K>
<DEF_14A>27</DEF_14A>
<SC_13G>41</SC_13G>
</formCounts>
<filingsLast30Days>3</filingsLast30Days>
<filingsLast90Days>9</filingsLast90Days>
<filingsLast365Days>74</filingsLast365Days>
<daysSinceLastFiling>62</daysSinceLastFiling>
<daysSinceLastAnnual>62</daysSinceLastAnnual>
<daysSinceLastQuarterly>154</daysSinceLastQuarterly>
<averageDaysBetweenFilings>12.4</averageDaysBetweenFilings>
<mostActiveForm>4</mostActiveForm>
</analytics>
</data>
</response>
status: ok
error: null
data:
ticker: AAPL
cik: '0000320193'
company: Apple Inc.
sic: '3571'
sicDescription: Electronic Computers
fiscalYearEnd: '0927'
totalRecentFilings: 1000
count: 4
latest:
annual:
form: 10-K
filingDate: '2025-11-01'
accessionNumber: 0000320193-25-000123
primaryDocument: aapl-20250927.htm
url: >-
https://www.sec.gov/Archives/edgar/data/320193/000032019325000123/aapl-20250927.htm
daysAgo: 62
quarterly:
form: 10-Q
filingDate: '2025-08-01'
accessionNumber: 0000320193-25-000106
primaryDocument: aapl-20250628.htm
url: >-
https://www.sec.gov/Archives/edgar/data/320193/000032019325000106/aapl-20250628.htm
daysAgo: 154
currentReport:
form: 8-K
filingDate: '2025-10-30'
accessionNumber: 0000320193-25-000121
primaryDocument: aapl-20251030.htm
url: >-
https://www.sec.gov/Archives/edgar/data/320193/000032019325000121/aapl-20251030.htm
daysAgo: 64
filings:
- form: 10-K
filingDate: '2025-11-01'
reportDate: '2025-09-27'
primaryDocDescription: 10-K
accessionNumber: 0000320193-25-000123
primaryDocument: aapl-20250927.htm
url: >-
https://www.sec.gov/Archives/edgar/data/320193/000032019325000123/aapl-20250927.htm
items: null
isXBRL: true
- form: 8-K
filingDate: '2025-10-30'
reportDate: '2025-10-30'
primaryDocDescription: 8-K
accessionNumber: 0000320193-25-000121
primaryDocument: aapl-20251030.htm
url: >-
https://www.sec.gov/Archives/edgar/data/320193/000032019325000121/aapl-20251030.htm
items: 2.02,9.01
isXBRL: true
- form: '4'
filingDate: '2025-10-16'
reportDate: '2025-10-14'
primaryDocDescription: FORM 4
accessionNumber: 0000320193-25-000118
primaryDocument: xslF345X05/wf-form4.xml
url: >-
https://www.sec.gov/Archives/edgar/data/320193/000032019325000118/xslF345X05/wf-form4.xml
items: null
isXBRL: false
- form: 10-Q
filingDate: '2025-08-01'
reportDate: '2025-06-28'
primaryDocDescription: 10-Q
accessionNumber: 0000320193-25-000106
primaryDocument: aapl-20250628.htm
url: >-
https://www.sec.gov/Archives/edgar/data/320193/000032019325000106/aapl-20250628.htm
items: null
isXBRL: true
analytics:
formCounts:
'3': 22
'4': 512
8-K: 96
10-Q: 84
10-K: 28
DEF 14A: 27
SC 13G: 41
filingsLast30Days: 3
filingsLast90Days: 9
filingsLast365Days: 74
daysSinceLastFiling: 62
daysSinceLastAnnual: 62
daysSinceLastQuarterly: 154
averageDaysBetweenFilings: 12.4
mostActiveForm: '4'
| key | value |
|---|---|
| ticker | AAPL |
| cik | 0000320193 |
| company | Apple Inc. |
| sic | 3571 |
| sicDescription | Electronic Computers |
| fiscalYearEnd | 0927 |
| totalRecentFilings | 1000 |
| count | 4 |
| latest | {annual:{form:10-K,filingDate:2025-11-01,accessionNumber:0000320193-25-000123,primaryDocument:aapl-20250927.htm,url:https://www.sec.gov/Archives/edgar/data/320193/000032019325000123/aapl-20250927.htm,daysAgo:62},quarterly:{form:10-Q,filingDate:2025-08-01,accessionNumber:0000320193-25-000106,primaryDocument:aapl-20250628.htm,url:https://www.sec.gov/Archives/edgar/data/320193/000032019325000106/aapl-20250628.htm,daysAgo:154},currentReport:{form:8-K,filingDate:2025-10-30,accessionNumber:0000320193-25-000121,primaryDocument:aapl-20251030.htm,url:https://www.sec.gov/Archives/edgar/data/320193/000032019325000121/aapl-20251030.htm,daysAgo:64}} |
| filings | [{form:10-K,filingDate:2025-11-01,reportDate:2025-09-27,primaryDocDescription:10-K,accessionNumber:0000320193-25-000123,primaryDocument:aapl-20250927.htm,url:https://www.sec.gov/Archives/edgar/data/320193/000032019325000123/aapl-20250927.htm,items:null,isXBRL:true},{form:8-K,filingDate:2025-10-30,reportDate:2025-10-30,primaryDocDescription:8-K,accessionNumber:0000320193-25-000121,primaryDocument:aapl-20251030.htm,url:https://www.sec.gov/Archives/edgar/data/320193/000032019325000121/aapl-20251030.htm,items:2.02,9.01,isXBRL:true},{form:4,filingDate:2025-10-16,reportDate:2025-10-14,primaryDocDescription:FORM 4,accessionNumber:0000320193-25-000118,primaryDocument:xslF345X05/wf-form4.xml,url:https://www.sec.gov/Archives/edgar/data/320193/000032019325000118/xslF345X05/wf-form4.xml,items:null,isXBRL:false},{form:10-Q,filingDate:2025-08-01,reportDate:2025-06-28,primaryDocDescription:10-Q,accessionNumber:0000320193-25-000106,primaryDocument:aapl-20250628.htm,url:https://www.sec.gov/Archives/edgar/data/320193/000032019325000106/aapl-20250628.htm,items:null,isXBRL:true}] |
| analytics | {formCounts:{3:22,4:512,8-K:96,10-Q:84,10-K:28,DEF 14A:27,SC 13G:41},filingsLast30Days:3,filingsLast90Days:9,filingsLast365Days:74,daysSinceLastFiling:62,daysSinceLastAnnual:62,daysSinceLastQuarterly:154,averageDaysBetweenFilings:12.4,mostActiveForm:4} |
Response Structure
All API responses follow a consistent structure with the following fields:
| Field | Type | Description | Example |
|---|---|---|---|
status | string | Indicates whether the request was successful ("ok") or failed ("error") | ok |
error | string | null | Contains error message if status is "error", otherwise null | null |
data | object | null | Contains the API response data if successful, otherwise null | {...} |
Learn more about response formats →
Response Data Fields
When the request is successful, the data object contains the following fields:
| Field | Type | Sample Value | Description |
|---|---|---|---|
ticker | string | Stock ticker symbol for the company | |
cik | string | SEC Central Index Key unique identifier | |
company | string | Official registered name of the company | |
sic | string | Standard Industrial Classification code | |
sicDescription | string | Industry description for the SIC code | |
fiscalYearEnd | string | Fiscal year end in MMDD format | |
totalRecentFilings | number | Total filings in the company's recent EDGAR feed | |
count | number | Number of filings returned in this response | |
latest | object | Most recent filing of each headline type | |
└ annualPremium | object | Most recent 10-K annual report | |
└ form | string | Form type (10-K) | |
└ filingDate | string | Date the annual report was filed | |
└ accessionNumber | string | SEC accession number for the filing | |
└ primaryDocument | string | Primary document filename | |
└ url | string | Direct link to the filing document | |
└ daysAgo | number | Days since the annual report was filed | |
└ quarterlyPremium | object | Most recent 10-Q quarterly report | |
└ form | string | Form type (10-Q) | |
└ filingDate | string | Date the quarterly report was filed | |
└ accessionNumber | string | SEC accession number for the filing |
Headers
Only X-API-Key is required. Optional headers include Accept for response format negotiation (JSON, XML, or YAML), User-Agent, and X-Request-ID for request tracing. See all request headers →
GraphQL AccessALPHA
Access SEC Filings through GraphQL to combine it with other API calls in a single request. Query only the sec filings data you need with precise field selection, and orchestrate complex data fetching workflows.
Credit Cost: Each API called in your GraphQL query consumes its standard credit cost.
POST https://api.apiverve.com/v1/graphqlquery {
secfilings(
input: {
ticker: "AAPL"
form: "10-K"
limit: 10
}
) {
ticker
cik
company
sic
sicDescription
fiscalYearEnd
totalRecentFilings
count
latest {
annual {
form
filingDate
accessionNumber
primaryDocument
url
daysAgo
}
quarterly {
form
filingDate
accessionNumber
primaryDocument
url
daysAgo
}
currentReport {
form
filingDate
accessionNumber
primaryDocument
url
daysAgo
}
}
filings
analytics {
formCounts {
3
4
8_K
10_Q
10_K
DEF 14A
SC 13G
}
filingsLast30Days
filingsLast90Days
filingsLast365Days
daysSinceLastFiling
daysSinceLastAnnual
daysSinceLastQuarterly
averageDaysBetweenFilings
mostActiveForm
}
}
}Note: Authentication is handled via the x-api-key header in your GraphQL request, not as a query parameter.
CORS Support
The SEC Filings API accepts cross-origin requests from any origin, so it can be called directly from browser-based applications without a proxy. See CORS support →
Rate Limiting
SEC Filings requests are throttled per minute on the Free plan and unthrottled on paid plans. Exceeding the limit returns 429 Too Many Requests; rate-limit usage is reported in the X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset response headers. See per-plan limits and best practices →
Error Codes
The SEC Filings API uses standard HTTP status codes — 200 on success, 400 for invalid parameters, 401 for missing or invalid keys, 403 for insufficient credits, 429 for rate-limit exhaustion, and 500/503 for server-side issues. Each error response includes an X-Request-ID header you can quote when contacting support. See full error handling guide →
SDKs for SEC Filings
Official SEC Filings packages on npm, PyPI, NuGet, and JitPack — plus a Postman collection and an OpenAPI spec. See the SDK guide →
No-Code Integrations
SEC Filings works with Zapier, Make, Pipedream, n8n, and Power Automate using the same API key. See setup guides →
Frequently Asked Questions
How do I get an API key for SEC Filings?
How many credits does SEC Filings cost?
Each successful SEC Filings API call consumes credits based on plan tier. Check the pricing section above for the exact credit cost. Failed requests and errors don't consume credits, so you only pay for successful sec filings lookups.
Can I use SEC Filings in production?
The free plan is for testing and development only. For production use of SEC Filings, upgrade to a paid plan (Starter, Pro, or Mega) which includes commercial use rights, no attribution requirements, and guaranteed uptime SLAs. All paid plans are production-ready.
Can I use SEC Filings from a browser?
What happens if I exceed my SEC Filings credit limit?
When you reach your monthly credit limit, SEC Filings API requests will return an error until you upgrade your plan or wait for the next billing cycle. You'll receive notifications at 80% and 95% usage to give you time to upgrade if needed.








