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.

All APIs

Contact Us to Get Access

By submitting this form you are opting in to receive email communications from Barchart for related product, service or company information, updates and announcements. You can unsubscribe at anytime. View our Privacy Policy.

Inputs

symbols required

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 

filingType required

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

maxRecords optional

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 

startDate optional

The beginning date for the query.

Type
date (A date in the format of YYYY-MM-DD.) 
Example
2019-10-22 

Outputs

Name / Requirement
Description
Type
symbol
always returned
A symbol or code that identifies a financial instrument.
string
A sequence of characters. (example: GOOG)
name
always returned
The name for the financial instrument.
string
A sequence of characters. (example: GOOG)
filingId
always returned
The identifying filing code.
string
A sequence of characters. (example: GOOG)
date
always returned
The timestamp for a news article.
date
A date in the format of YYYY-MM-DD.
form
always returned
The type of filing.
string
A sequence of characters. (example: GOOG)
description
always returned
The name of the filing.
string
A sequence of characters. (example: GOOG)
pdfURL
always returned
The web location of a PDF version of the filing.
string
A sequence of characters. (example: GOOG)
htmlURL
always returned
The web location of a HTML version of the filing.
string
A sequence of characters. (example: GOOG)
wordURL
always returned
The web location of a Word version of the filing.
string
A sequence of characters. (example: GOOG)
excelURL
always returned
The web location of an Excel version of the filing.
string
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=2019-10-22
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=2019-10-22

Response

{
    "status": {
        "code": 200,
        "message": "Success."
    },
    "results": [
        {
            "symbol": "IBM",
            "name": "International Business Machines",
            "filingId": "13688557",
            "date": "2019-10-16",
            "form": "8-K",
            "description": "Current report filing",
            "pdfURL": "https:\/\/barchart.websol.barchart.com\/?module=secFilings&filingid=13688557&type=CONVPDF&popup=1&override=1&symbol=IBM",
            "htmlURL": "https:\/\/barchart.websol.barchart.com\/?module=secFilings&filingid=13688557&type=HTML&popup=1&override=1&symbol=IBM",
            "wordURL": "https:\/\/barchart.websol.barchart.com\/?module=secFilings&filingid=13688557&type=RTF&popup=1&override=1&symbol=IBM",
            "excelURL": "https:\/\/barchart.websol.barchart.com\/?module=secFilings&filingid=13688557&type=XLS&popup=1&override=1&symbol=IBM"
        }
    ]
}

XML

GET

GET https://ondemand.websol.barchart.com/getSECFilings.xml?apikey=YOUR_API_KEY&symbols=AAPL%2CIBM&filingType=AllEx&maxRecords=10&startDate=2019-10-22
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=2019-10-22

Response


<?xml version="1.0" encoding="utf-8"?>
 <getSECFilings>
  <status>
   <code>200</code>
   <message>Success.</message>
  </status>
  <item>
   <symbol>IBM</symbol>
   <name>International Business Machines</name>
   <filingId>13688557</filingId>
   <date>2019-10-16</date>
   <form>8-K</form>
   <description>Current report filing</description>
   <pdfURL>https://barchart.websol.barchart.com/?module=secFilings&amp;filingid=13688557&amp;type=CONVPDF&amp;popup=1&amp;override=1&amp;symbol=IBM</pdfURL>
   <htmlURL>https://barchart.websol.barchart.com/?module=secFilings&amp;filingid=13688557&amp;type=HTML&amp;popup=1&amp;override=1&amp;symbol=IBM</htmlURL>
   <wordURL>https://barchart.websol.barchart.com/?module=secFilings&amp;filingid=13688557&amp;type=RTF&amp;popup=1&amp;override=1&amp;symbol=IBM</wordURL>
   <excelURL>https://barchart.websol.barchart.com/?module=secFilings&amp;filingid=13688557&amp;type=XLS&amp;popup=1&amp;override=1&amp;symbol=IBM</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=2019-10-22
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=2019-10-22

Response

symbol,name,filingId,date,form,description,pdfURL,htmlURL,wordURL,excelURL
"IBM","International Business Machines","13688557","2019-10-16","8-K","Current report filing","https://barchart.websol.barchart.com/?module=secFilings&filingid=13688557&type=CONVPDF&popup=1&override=1&symbol=IBM","https://barchart.websol.barchart.com/?module=secFilings&filingid=13688557&type=HTML&popup=1&override=1&symbol=IBM","https://barchart.websol.barchart.com/?module=secFilings&filingid=13688557&type=RTF&popup=1&override=1&symbol=IBM","https://barchart.websol.barchart.com/?module=secFilings&filingid=13688557&type=XLS&popup=1&override=1&symbol=IBM"


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' => '2019-10-22',
];

$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", "2019-10-22")

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', '2019-10-22');

print $result;

Python

from suds.client import Client
ondemand = Client('https://ondemand.websol.barchart.com/service?wsdl')

result = client.service.getSECFilings('YOUR_API_KEY', 'AAPL,IBM', 'AllEx', '10', '2019-10-22')

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: '2019-10-22',
    }
)

response.body