SEC Filings API
getSECFilings
The getSECFilings API provides access to quarterly, annual and other required regulatory/SEC filings for U.S. publicly traded companies based on symbol.
View All APIsContact Us to Get Access
Inputs
symbolsrequired
A symbol or code that identifies a financial instrument. Multiple symbols separated by a comma may be used.
Type
list (A comma or semi-colon delimited string.)
Example
AAPL,IBM
filingTyperequired
The type of SEC filing. Includes: All Filings, except stock transaction reports ("AllEx"), All, including stock transaction reports ("All"), Annual 10-K Reports ("10k") and Quarterly 10-Q Reports ("10q").
Type
enum (A type which includes a list of valid possible values.)
Example
AllEx
Valid Values
AllEx, All, 10k, 10q
maxRecordsoptional
The maximum number of records to show in the return.
Type
int (A numeric type defining a whole number. (example: 2))
Example
10
Default
20
startDateoptional
The beginning date for the query.
Type
date (A date in the format of YYYY-MM-DD.)
Example
2024-10-01
Outputs
symbol
always returned
always returned
A symbol or code that identifies a financial instrument.
string
A sequence of characters. (example: GOOG)
A sequence of characters. (example: GOOG)
name
always returned
always returned
The name for the financial instrument.
string
A sequence of characters. (example: GOOG)
A sequence of characters. (example: GOOG)
filingId
always returned
always returned
The identifying filing code.
string
A sequence of characters. (example: GOOG)
A sequence of characters. (example: GOOG)
date
always returned
always returned
The timestamp for a news article.
date
A date in the format of YYYY-MM-DD.
A date in the format of YYYY-MM-DD.
form
always returned
always returned
The type of filing.
string
A sequence of characters. (example: GOOG)
A sequence of characters. (example: GOOG)
description
always returned
always returned
The name of the filing.
string
A sequence of characters. (example: GOOG)
A sequence of characters. (example: GOOG)
pdfURL
always returned
always returned
The web location of a PDF version of the filing.
string
A sequence of characters. (example: GOOG)
A sequence of characters. (example: GOOG)
htmlURL
always returned
always returned
The web location of a HTML version of the filing.
string
A sequence of characters. (example: GOOG)
A sequence of characters. (example: GOOG)
wordURL
always returned
always returned
The web location of a Word version of the filing.
string
A sequence of characters. (example: GOOG)
A sequence of characters. (example: GOOG)
excelURL
always returned
always returned
The web location of an Excel version of the filing.
string
A sequence of characters. (example: GOOG)
A sequence of characters. (example: GOOG)
Status Code Responses
200
OK
Success
400
Bad Request
The request was invalid, please see the message for more information.
500
Internal Server Error
Something is not working correctly, please contact support.
JSON
GET
GET https://ondemand.websol.barchart.com/getSECFilings.json?apikey=YOUR_API_KEY&symbols=AAPL%2CIBM&filingType=AllEx&maxRecords=10&startDate=2024-10-01
Host: ondemand.websol.barchart.com
POST
POST https://ondemand.websol.barchart.com/getSECFilings.json
Host: ondemand.websol.barchart.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length
apikey=YOUR_API_KEY&symbols=AAPL%2CIBM&filingType=AllEx&maxRecords=10&startDate=2024-10-01
Response
{
"status": {
"code": 200,
"message": "Success."
},
"results": [
{
"symbol": "AAPL",
"name": "Apple Inc",
"filingId": null,
"date": "2024-10-04",
"form": "144",
"description": "Report of proposed sale of securities",
"pdfURL": "https:\/\/barchart.websol.barchart.com\/?module=secFilings&accession_num=0001958244-24-005135&cik=320193&type=CONVPDF&popup=1&override=1&symbol=AAPL",
"htmlURL": "https:\/\/barchart.websol.barchart.com\/?module=secFilings&accession_num=0001958244-24-005135&cik=320193&type=HTML&popup=1&override=1&symbol=AAPL",
"wordURL": "https:\/\/barchart.websol.barchart.com\/?module=secFilings&accession_num=0001958244-24-005135&cik=320193&type=RTF&popup=1&override=1&symbol=AAPL",
"excelURL": null
},
{
"symbol": "AAPL",
"name": "Apple Inc",
"filingId": null,
"date": "2024-10-02",
"form": "144",
"description": "Report of proposed sale of securities",
"pdfURL": "https:\/\/barchart.websol.barchart.com\/?module=secFilings&accession_num=0001950047-24-007542&cik=320193&type=CONVPDF&popup=1&override=1&symbol=AAPL",
"htmlURL": "https:\/\/barchart.websol.barchart.com\/?module=secFilings&accession_num=0001950047-24-007542&cik=320193&type=HTML&popup=1&override=1&symbol=AAPL",
"wordURL": "https:\/\/barchart.websol.barchart.com\/?module=secFilings&accession_num=0001950047-24-007542&cik=320193&type=RTF&popup=1&override=1&symbol=AAPL",
"excelURL": null
},
{
"symbol": "AAPL",
"name": "Apple Inc",
"filingId": null,
"date": "2024-10-02",
"form": "144",
"description": "Report of proposed sale of securities",
"pdfURL": "https:\/\/barchart.websol.barchart.com\/?module=secFilings&accession_num=0001973141-24-000479&cik=320193&type=CONVPDF&popup=1&override=1&symbol=AAPL",
"htmlURL": "https:\/\/barchart.websol.barchart.com\/?module=secFilings&accession_num=0001973141-24-000479&cik=320193&type=HTML&popup=1&override=1&symbol=AAPL",
"wordURL": "https:\/\/barchart.websol.barchart.com\/?module=secFilings&accession_num=0001973141-24-000479&cik=320193&type=RTF&popup=1&override=1&symbol=AAPL",
"excelURL": null
},
{
"symbol": "AAPL",
"name": "Apple Inc",
"filingId": null,
"date": "2024-10-02",
"form": "144",
"description": "Report of proposed sale of securities",
"pdfURL": "https:\/\/barchart.websol.barchart.com\/?module=secFilings&accession_num=0001973141-24-000478&cik=320193&type=CONVPDF&popup=1&override=1&symbol=AAPL",
"htmlURL": "https:\/\/barchart.websol.barchart.com\/?module=secFilings&accession_num=0001973141-24-000478&cik=320193&type=HTML&popup=1&override=1&symbol=AAPL",
"wordURL": "https:\/\/barchart.websol.barchart.com\/?module=secFilings&accession_num=0001973141-24-000478&cik=320193&type=RTF&popup=1&override=1&symbol=AAPL",
"excelURL": null
},
{
"symbol": "AAPL",
"name": "Apple Inc",
"filingId": null,
"date": "2024-10-02",
"form": "144",
"description": "Report of proposed sale of securities",
"pdfURL": "https:\/\/barchart.websol.barchart.com\/?module=secFilings&accession_num=0001959173-24-006827&cik=320193&type=CONVPDF&popup=1&override=1&symbol=AAPL",
"htmlURL": "https:\/\/barchart.websol.barchart.com\/?module=secFilings&accession_num=0001959173-24-006827&cik=320193&type=HTML&popup=1&override=1&symbol=AAPL",
"wordURL": "https:\/\/barchart.websol.barchart.com\/?module=secFilings&accession_num=0001959173-24-006827&cik=320193&type=RTF&popup=1&override=1&symbol=AAPL",
"excelURL": null
}
]
}
XML
GET
GET https://ondemand.websol.barchart.com/getSECFilings.xml?apikey=YOUR_API_KEY&symbols=AAPL%2CIBM&filingType=AllEx&maxRecords=10&startDate=2024-10-01
Host: ondemand.websol.barchart.com
POST
POST https://ondemand.websol.barchart.com/getSECFilings.xml
Host: ondemand.websol.barchart.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length
apikey=YOUR_API_KEY&symbols=AAPL%2CIBM&filingType=AllEx&maxRecords=10&startDate=2024-10-01
Response
<?xml version="1.0" encoding="utf-8"?>
<getSECFilings>
<status>
<code>200</code>
<message>Success.</message>
</status>
<item>
<symbol>AAPL</symbol>
<name>Apple Inc</name>
<filingId/>
<date>2024-10-04</date>
<form>144</form>
<description>Report of proposed sale of securities</description>
<pdfURL>https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001958244-24-005135&cik=320193&type=CONVPDF&popup=1&override=1&symbol=AAPL</pdfURL>
<htmlURL>https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001958244-24-005135&cik=320193&type=HTML&popup=1&override=1&symbol=AAPL</htmlURL>
<wordURL>https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001958244-24-005135&cik=320193&type=RTF&popup=1&override=1&symbol=AAPL</wordURL>
<excelURL/>
</item>
<item>
<symbol>AAPL</symbol>
<name>Apple Inc</name>
<filingId/>
<date>2024-10-02</date>
<form>144</form>
<description>Report of proposed sale of securities</description>
<pdfURL>https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001950047-24-007542&cik=320193&type=CONVPDF&popup=1&override=1&symbol=AAPL</pdfURL>
<htmlURL>https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001950047-24-007542&cik=320193&type=HTML&popup=1&override=1&symbol=AAPL</htmlURL>
<wordURL>https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001950047-24-007542&cik=320193&type=RTF&popup=1&override=1&symbol=AAPL</wordURL>
<excelURL/>
</item>
<item>
<symbol>AAPL</symbol>
<name>Apple Inc</name>
<filingId/>
<date>2024-10-02</date>
<form>144</form>
<description>Report of proposed sale of securities</description>
<pdfURL>https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001973141-24-000479&cik=320193&type=CONVPDF&popup=1&override=1&symbol=AAPL</pdfURL>
<htmlURL>https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001973141-24-000479&cik=320193&type=HTML&popup=1&override=1&symbol=AAPL</htmlURL>
<wordURL>https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001973141-24-000479&cik=320193&type=RTF&popup=1&override=1&symbol=AAPL</wordURL>
<excelURL/>
</item>
<item>
<symbol>AAPL</symbol>
<name>Apple Inc</name>
<filingId/>
<date>2024-10-02</date>
<form>144</form>
<description>Report of proposed sale of securities</description>
<pdfURL>https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001973141-24-000478&cik=320193&type=CONVPDF&popup=1&override=1&symbol=AAPL</pdfURL>
<htmlURL>https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001973141-24-000478&cik=320193&type=HTML&popup=1&override=1&symbol=AAPL</htmlURL>
<wordURL>https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001973141-24-000478&cik=320193&type=RTF&popup=1&override=1&symbol=AAPL</wordURL>
<excelURL/>
</item>
<item>
<symbol>AAPL</symbol>
<name>Apple Inc</name>
<filingId/>
<date>2024-10-02</date>
<form>144</form>
<description>Report of proposed sale of securities</description>
<pdfURL>https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001959173-24-006827&cik=320193&type=CONVPDF&popup=1&override=1&symbol=AAPL</pdfURL>
<htmlURL>https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001959173-24-006827&cik=320193&type=HTML&popup=1&override=1&symbol=AAPL</htmlURL>
<wordURL>https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001959173-24-006827&cik=320193&type=RTF&popup=1&override=1&symbol=AAPL</wordURL>
<excelURL/>
</item>
</getSECFilings>
CSV
GET
GET https://ondemand.websol.barchart.com/getSECFilings.csv?apikey=YOUR_API_KEY&symbols=AAPL%2CIBM&filingType=AllEx&maxRecords=10&startDate=2024-10-01
Host: ondemand.websol.barchart.com
POST
POST https://ondemand.websol.barchart.com/getSECFilings.csv
Host: ondemand.websol.barchart.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length
apikey=YOUR_API_KEY&symbols=AAPL%2CIBM&filingType=AllEx&maxRecords=10&startDate=2024-10-01
Response
symbol,name,filingId,date,form,description,pdfURL,htmlURL,wordURL,excelURL
"AAPL","Apple Inc","","2024-10-04","144","Report of proposed sale of securities","https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001958244-24-005135&cik=320193&type=CONVPDF&popup=1&override=1&symbol=AAPL","https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001958244-24-005135&cik=320193&type=HTML&popup=1&override=1&symbol=AAPL","https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001958244-24-005135&cik=320193&type=RTF&popup=1&override=1&symbol=AAPL",""
"AAPL","Apple Inc","","2024-10-02","144","Report of proposed sale of securities","https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001950047-24-007542&cik=320193&type=CONVPDF&popup=1&override=1&symbol=AAPL","https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001950047-24-007542&cik=320193&type=HTML&popup=1&override=1&symbol=AAPL","https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001950047-24-007542&cik=320193&type=RTF&popup=1&override=1&symbol=AAPL",""
"AAPL","Apple Inc","","2024-10-02","144","Report of proposed sale of securities","https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001973141-24-000479&cik=320193&type=CONVPDF&popup=1&override=1&symbol=AAPL","https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001973141-24-000479&cik=320193&type=HTML&popup=1&override=1&symbol=AAPL","https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001973141-24-000479&cik=320193&type=RTF&popup=1&override=1&symbol=AAPL",""
"AAPL","Apple Inc","","2024-10-02","144","Report of proposed sale of securities","https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001973141-24-000478&cik=320193&type=CONVPDF&popup=1&override=1&symbol=AAPL","https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001973141-24-000478&cik=320193&type=HTML&popup=1&override=1&symbol=AAPL","https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001973141-24-000478&cik=320193&type=RTF&popup=1&override=1&symbol=AAPL",""
"AAPL","Apple Inc","","2024-10-02","144","Report of proposed sale of securities","https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001959173-24-006827&cik=320193&type=CONVPDF&popup=1&override=1&symbol=AAPL","https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001959173-24-006827&cik=320193&type=HTML&popup=1&override=1&symbol=AAPL","https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001959173-24-006827&cik=320193&type=RTF&popup=1&override=1&symbol=AAPL",""
PHP
<?php
$ondemand = new SoapClient('https://ondemand.websol.barchart.com/service?wsdl');
$params = [
'apikey' => 'YOUR_API_KEY',
'symbols' => 'AAPL,IBM',
'filingType' => 'AllEx',
'maxRecords' => '10',
'startDate' => '2024-10-01',
];
$result = $ondemand->getSECFilings($params);
var_dump($result);
Classic ASP
Dim ondemand
Dim result
Set ondemand = Server.CreateObject("MSSOAP.SoapClient30")
ondemand.ClientProperty("ServerHTTPRequest") = True
ondemand.MSSoapInit("https://ondemand.websol.barchart.com/service?wsdl")
Set result = ondemand.getSECFilings("YOUR_API_KEY", "AAPL,IBM", "AllEx", "10", "2024-10-01")
Perl
use SOAP::Lite;
use SOAP::WSDL;
my $ondemand = SOAP::Lite
-> service('https://ondemand.websol.barchart.com/service?wsdl');
my $result = $ondemand->getSECFilings('YOUR_API_KEY', 'AAPL,IBM', 'AllEx', '10', '2024-10-01');
print $result;
Python
from suds.client import Client
ondemand = Client('https://ondemand.websol.barchart.com/service?wsdl')
result = ondemand.service.getSECFilings('YOUR_API_KEY', 'AAPL,IBM', 'AllEx', '10', '2024-10-01')
print(result)
Ruby
require 'savon'
ondemand = Savon.client(wsdl: 'https://ondemand.websol.barchart.com/service?wsdl')
response = ondemand.call(
:getSECFilings,
message: {
apikey: 'YOUR_API_KEY',
symbols: 'AAPL,IBM',
filingType: 'AllEx',
maxRecords: '10',
startDate: '2024-10-01',
}
)
response.body