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 APIs

Contact Us to Get Access

First Name^*

Last Name^*

Email Address^*

Phone^*

Company^*

Role^*

Industry^*

Country^*

What you are looking for?^*

Please provide as much information as possible (e.g. exchanges, markets or other data sources), the APIs you are interested in (e.g. getQuote, getHistory, getChart, getCorporateActions, etc.), and your use case.

Here are some examples: Example #1, Example #2, Example #3.

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

2024-12-11

Outputs

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=2024-12-11
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-12-11

Response

{
    "status": {
        "code": 200,
        "message": "Success."
    },
    "results": [
        {
            "symbol": "AAPL",
            "name": "Apple Inc",
            "filingId": null,
            "date": "2024-12-16",
            "form": "144",
            "description": "Report of proposed sale of securities",
            "pdfURL": "https:\/\/barchart.websol.barchart.com\/?module=secFilings&accession_num=0001973141-24-000617&cik=320193&type=CONVPDF&popup=1&override=1&symbol=AAPL",
            "htmlURL": "https:\/\/barchart.websol.barchart.com\/?module=secFilings&accession_num=0001973141-24-000617&cik=320193&type=HTML&popup=1&override=1&symbol=AAPL",
            "wordURL": "https:\/\/barchart.websol.barchart.com\/?module=secFilings&accession_num=0001973141-24-000617&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-12-11
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-12-11

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-12-16</date>
    <form>144</form>
    <description>Report of proposed sale of securities</description>
    <pdfURL>https://barchart.websol.barchart.com/?module=secFilings&amp;accession_num=0001973141-24-000617&amp;cik=320193&amp;type=CONVPDF&amp;popup=1&amp;override=1&amp;symbol=AAPL</pdfURL>
    <htmlURL>https://barchart.websol.barchart.com/?module=secFilings&amp;accession_num=0001973141-24-000617&amp;cik=320193&amp;type=HTML&amp;popup=1&amp;override=1&amp;symbol=AAPL</htmlURL>
    <wordURL>https://barchart.websol.barchart.com/?module=secFilings&amp;accession_num=0001973141-24-000617&amp;cik=320193&amp;type=RTF&amp;popup=1&amp;override=1&amp;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-12-11
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-12-11

Response

symbol,name,filingId,date,form,description,pdfURL,htmlURL,wordURL,excelURL
"AAPL","Apple Inc","","2024-12-16","144","Report of proposed sale of securities","https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001973141-24-000617&cik=320193&type=CONVPDF&popup=1&override=1&symbol=AAPL","https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001973141-24-000617&cik=320193&type=HTML&popup=1&override=1&symbol=AAPL","https://barchart.websol.barchart.com/?module=secFilings&accession_num=0001973141-24-000617&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-12-11',
];

$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-12-11")

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-12-11');

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-12-11')

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-12-11',
    }
)

response.body