getSECFilings API

The getSECFilings API provides access to quarterly, annual and other required regulatory/SEC filings for U.S. publically traded companies based on symbol.

All APIs

Contact Us to Get Access

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
2017-11-24 

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=2017-11-24
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=2017-11-24

Response

{
    "status": {
        "code": 204,
        "message": "Success, but no content to return."
    },
    "results": null
}

XML

GET

GET https://ondemand.websol.barchart.com/getSECFilings.xml?apikey=<YOUR API KEY>&symbols=AAPL%2CIBM&filingType=AllEx&maxRecords=10&startDate=2017-11-24
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=2017-11-24

Response


<?xml version="1.0" encoding="utf-8"?>
 <getSECFilings>
  <status>
   <code>204</code>
   <message>Success, but no content to return.</message>
  </status>
 </getSECFilings>

CSV

GET

GET https://ondemand.websol.barchart.com/getSECFilings.csv?apikey=<YOUR API KEY>&symbols=AAPL%2CIBM&filingType=AllEx&maxRecords=10&startDate=2017-11-24
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=2017-11-24

Response




PHP

<?php

$ondemand = new SoapClient('https://ondemand.websol.barchart.com/service?wsdl');

$params = [
    'symbols' => 'AAPL,IBM',
    'filingType' => 'AllEx',
    'maxRecords' => '10',
    'startDate' => '2017-11-24',
];

$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("AAPL,IBM", "AllEx", "10", "2017-11-24")

Perl

use SOAP::Lite;
use SOAP::WSDL;

my $ondemand = SOAP::Lite
    -> service('https://ondemand.websol.barchart.com/service?wsdl');

my $result = $ondemand->getSECFilings('AAPL,IBM', 'AllEx', '10', '2017-11-24');

print $result;

Python

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

result = client.service.getSECFilings('AAPL,IBM', 'AllEx', '10', '2017-11-24')

print result

Ruby

require 'savon'

ondemand = Savon.client(wsdl: 'https://ondemand.websol.barchart.com/service?wsdl')

response = ondemand.call(
    :getSECFilings,
    message: {
        symbols: 'AAPL,IBM',
        filingType: 'AllEx',
        maxRecords: '10',
        startDate: '2017-11-24',
    }
)

response.body