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.

Pricing is based on the number of monthly queries and fields requested. We offer four packages: Small, Medium, Large, Enterprise. Contact us for additional details.


API Documentation

INPUTS:

symbols (required)
A symbol or code that identifies an financial instrument. Multiple symbols separated by a comma may be used. (list)
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"). (enum)
Valid values: AllEx, All, 10k, 10q
Example: AllEx

maxRecords (optional)
The maximum number of records to show in the return. (int)
Default: 20
Example: 10

startDate (optional)
The beginning date for the query. (date)
Example: 2017-06-25


OUTPUTS:

symbol (always returned)
A symbol or code that identifies a financial instrument. (string)
name (always returned)
The name for the financial instrument. (string)
filingId (always returned)
The identifying filing code. (string)
date (always returned)
The timestamp for a news article. (date)
form (always returned)
The type of filing. (string)
description (always returned)
The name of the filing. (string)
pdfURL (always returned)
The web location of a PDF version of the filing. (string)
htmlURL (always returned)
The web location of a HTML version of the filing. (string)
wordURL (always returned)
The web location of a Word version of the filing. (string)
excelURL (always returned)
The web location of a Excel version of the filing. (string)

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.