You can find more examples and details here: sec-api.io/docs
Data source: sec.gov
You can use the API in your command line, or develop your own application using the API as imported package. Both options are explained below.
Before you start:
brew install node.The query API allows you to search and filter all 18 million filings published on SEC EDGAR.
The example below returns the most recent 10-Q filings.
const { queryApi } = require('sec-api');
queryApi.setApiKey('YOUR_API_KEY');
const query = {
query: { query_string: { query: 'formType:"10-Q"' } }, // get most recent 10-Q filings
from: '0', // start with first filing. used for pagination.
size: '10', // limit response to 10 filings
sort: [{ filedAt: { order: 'desc' } }], // sort result by filedAt
};
const filings = await queryApi.getFilings(rawQuery);
See the documentation for more details: https://sec-api.io/docs/query-api
Full-text search allows you to search the full text of all EDGAR filings submitted since 2001. The full text of a filing includes all data in the filing itself as well as all attachments (such as exhibits) to the filing.
The example below returns all 8-K and 10-Q filings and their exhibits, filed between 01-01-2021 and 14-06-2021, that include the exact phrase "LPCN 1154".
const { fullTextSearchApi } = require('sec-api');
fullTextSearchApi.setApiKey('YOUR_API_KEY');
const query = {
query: '"LPCN 1154"',
formTypes: ['8-K', '10-Q'],
startDate: '2021-01-01',
endDate: '2021-06-14',
};
const filings = await fullTextSearchApi.getFilings(rawQuery);
See the documentation for more details: https://sec-api.io/docs/full-text-search-api
The stream API provides a live stream (aka feed) of newly published filings on SEC EDGAR. A new filing is sent to your connected client as soon as its published.
Type in your command line:
mkdir my-project && cd my-project to create a new folder for your project.npm init -y to set up Node.js boilerplate.npm install sec-api to install the package.touch index.js to create a new file. Copy/paste the example code below
into the file index.js. Replace YOUR_API_KEY with the API key provided on sec-api.ioconst { streamApi } = require('sec-api');
streamApi.connect('YOUR_API_KEY');
streamApi.on('filing', (filing) => console.log(filing));
node index.js to start listening for new filings. New filings are
printed in your console as soon as they are published on SEC EDGAR.See the documentation for more details: https://sec-api.io/docs/stream-api
In your command line, type
npm install sec-api -g to install the packagesec-api YOUR_API_KEY to connect to the stream. Replace YOUR_API_KEY with
the API key provided on sec-api.ioLive Demo: https://codesandbox.io/s/01xqz2ml9l (requires an API key to work)
import { streamApi } from 'sec-api';
class Filings extends React.Component {
componentDidMount() {
const socket = streamApi('YOUR_API_KEY');
socket.on('filing', (filing) => console.log(filing));
}
// ...
}
Parse and standardize any XBRL and convert it to JSON. Extract financial statements and meta data from 10-K and 10-Q filings.
The entire US GAAP taxonomy is fully supported. All XBRL items are fully converted into JSON, including us-gaap, dei and custom items. XBRL facts are automatically mapped to their respective context including period instants and date ranges.
All financial statements are accessible and standardized:
Variants such as ConsolidatedStatementsofOperations or ConsolidatedStatementsOfLossIncome are automatically standardized to their root name, e.g. StatementsOfIncome.
{
"StatementsOfIncome": {
"RevenueFromContractWithCustomerExcludingAssessedTax": [
{
"decimals": "-6",
"unitRef": "usd",
"period": {
"startDate": "2019-09-29",
"endDate": "2020-09-26"
},
"value": "274515000000"
},
{
"decimals": "-6",
"unitRef": "usd",
"period": {
"startDate": "2018-09-30",
"endDate": "2019-09-28"
},
"value": "260174000000"
}
]
}
}
There are 3 ways to convert XBRL to JSON:
htmUrl: Provide the URL of the filing ending with .htm.
Example URL: https://www.sec.gov/Archives/edgar/data/1318605/000156459021004599/tsla-10k_20201231.htmxbrlUrl: Provide the URL of the XBRL file ending with .xml. The XBRL file URL can be found in the dataFiles array returned by our query API. The array item has the description EXTRACTED XBRL INSTANCE DOCUMENT or similar.
Example URL: https://www.sec.gov/Archives/edgar/data/1318605/000156459021004599/tsla-10k_20201231_htm.xmlaccessionNo: Provide the accession number of the filing, e.g. 0001564590-21-004599const { xbrlApi } = secApi;
xbrlApi.setApiKey('YOUR_API_KEY');
// 10-K HTM File URL example
xbrlApi
.xbrlToJson({
htmUrl:
'https://www.sec.gov/Archives/edgar/data/320193/000032019320000096/aapl-20200926.htm',
})
.then(console.log);
// 10-K XBRL File URL Example
xbrlApi
.xbrlToJson({
xbrlUrl:
'https://www.sec.gov/Archives/edgar/data/320193/000032019320000096/aapl-20200926_htm.xml',
})
.then(console.log);
// 10-K Accession Number Example
xbrlApi.xbrlToJson({ accessionNo: '0000320193-20-000096' }).then(console.log);
Note: response is shortened.
{
"CoverPage": {
"DocumentPeriodEndDate": "2020-09-26",
"EntityRegistrantName": "Apple Inc.",
"EntityIncorporationStateCountryCode": "CA",
"EntityTaxIdentificationNumber": "94-2404110",
"EntityAddressAddressLine1": "One Apple Park Way",
"EntityAddressCityOrTown": "Cupertino",
"EntityAddressStateOrProvince": "CA",
"EntityAddressPostalZipCode": "95014",
"CityAreaCode": "408",
"LocalPhoneNumber": "996-1010",
"TradingSymbol": "AAPL",
"EntityPublicFloat": {
"decimals": "-6",
"unitRef": "usd",
"period": {
"instant": "2020-03-27"
},
"value": "1070633000000"
},
"EntityCommonStockSharesOutstanding": {
"decimals": "-3",
"unitRef": "shares",
"period": {
"instant": "2020-10-16"
},
"value": "17001802000"
},
"DocumentFiscalPeriodFocus": "FY",
"CurrentFiscalYearEndDate": "--09-26"
},
"StatementsOfIncome": {
"RevenueFromContractWithCustomerExcludingAssessedTax": [
{
"decimals": "-6",
"unitRef": "usd",
"period": {
"startDate": "2019-09-29",
"endDate": "2020-09-26"
},
"segment": {
"dimension": "srt:ProductOrServiceAxis",
"value": "us-gaap:ProductMember"
},
"value": "220747000000"
},
{
"decimals": "-6",
"unitRef": "usd",
"period": {
"startDate": "2018-09-30",
"endDate": "2019-09-28"
},
"segment": {
"dimension": "srt:ProductOrServiceAxis",
"value": "us-gaap:ProductMember"
},
"value": "213883000000"
}
]
},
"BalanceSheets": {
"CashAndCashEquivalentsAtCarryingValue": [
{
"decimals": "-6",
"unitRef": "usd",
"period": {
"instant": "2020-09-26"
},
"value": "38016000000"
},
{
"decimals": "-6",
"unitRef": "usd",
"period": {
"instant": "2019-09-28"
},
"value": "48844000000"
},
{
"decimals": "-6",
"unitRef": "usd",
"period": {
"instant": "2020-09-26"
},
"segment": {
"dimension": "us-gaap:FinancialInstrumentAxis",
"value": "us-gaap:CashMember"
},
"value": "17773000000"
}
]
}
See the documentation for more details: https://sec-api.io/docs/xbrl-to-json-converter-api
The Extractor API returns individual sections from 10-Q and 10-K filings. The extracted section is cleaned and standardized - in raw text or in standardized HTML. You can programmatically extract one or multiple sections from any 10-Q and 10-K filing.
All 10-K and 10-Q sections can be extracted:
const { extractorApi } = secApi;
// Tesla 10-K filing
const filingUrl =
'https://www.sec.gov/Archives/edgar/data/1318605/000156459021004599/tsla-10k_20201231.htm';
const sectionText = await extractorApi.getSection(filingUrl, '1A', 'text');
const sectionHtml = await extractorApi.getSection(filingUrl, '1A', 'html');
console.log(sectionText);
console.log(sectionHtml);
See the documentation for more details: https://sec-api.io/docs/sec-filings-item-extraction-api
Download or render up to 40 filings per second. All filings, exhibits and attachements are supported. Access over 650,000 gigabyte of filings data. You can process the downloaded data in memory or save it to your hard drive.
const { renderApi } = require('sec-api');
renderApi.setApiKey('YOUR_API_KEY');
const filingUrl =
'https://www.sec.gov/Archives/edgar/data/1841925/000121390021032758/ea142795-8k_indiesemic.htm';
const filingContent = await renderApi.getFilingContent(filingUrl);
See the documentation for more details: https://sec-api.io/docs/sec-filings-render-api
accessionNo (string) - Accession number of filing, e.g. 0000028917-20-000033cik (string) - CIK of the filing issuer. Important: trailing 0 are removed.ticker (string) - Ticker of company, e.g. AMOT. A ticker is not available when non-publicly traded companies report filings (e.g. form 4 reported by directors). Please contact us if you find filings that you think should have tickers (but don't).companyName (string) - Name of company, e.g. Allied Motion Technologies InccompanyNameLong (string) - Long version of company name including the filer type (Issuer, Filer, Reporting), e.g. ALLIED MOTION TECHNOLOGIES INC (0000046129) (Issuer)formType (string) - sec.gov form type, e.g 10-K. See the list of supported form types here.description (string) - Description of the form, e.g. Statement of changes in beneficial ownership of securitieslinkToFilingDetails (string) - Link to HTML, XML or PDF version of the filing.linkToTxt (string) - Link to the plain text version of the filing. This file can be multiple MBs large.linkToHtml (string) - Link to index page of the filing listing all exhibits and the original HTML file.linkToXbrl (string, optional) - Link to XBRL version of the filing (if available).filedAt (string) - The date (format: YYYY-MM-DD HH:mm:SS TZ) the filing was filed, eg 2019-12-06T14:41:26-05:00.periodOfReport (string, if reported) - Period of report, e.g. 2021-06-08effectivenessDate (string, if reported) - Effectiveness date, e.g. 2021-06-08id (string) - Unique ID of the filing.entities (array) - A list of all entities referred to in the filing. The first item in the array always represents the filing issuer. Each array element is an object with the following keys:
companyName (string) - Company name of the entity, e.g. DILLARD'S, INC. (Issuer)cik (string) - CIK of the entity. Trailing 0 are not removed here, e.g. 0000028917irsNo (string, optional) - IRS number of the entity, e.g. 710388071stateOfIncorporation (string, optional) - State of incorporation of entity, e.g. ARfiscalYearEnd (string, optional) - Fiscal year end of the entity, e.g. 0201sic (string, optional) - SIC of the entity, e.g. 5311 Retail-Department Storestype (string, optional) - Type of the filing being filed. Same as formType, e.g. 4act (string, optional) - The SEC act pursuant to which the filing was filed, e.g. 34fileNo (string, optional) - Filer number of the entity, e.g. 001-06140filmNo (string, optional) - Film number of the entity, e.g. 20575664documentFormatFiles (array) - An array listing all primary files of the filing. The first item of the array is always the filing itself. The last item of the array is always the TXT version of the filing. All other items can represent exhibits, press releases, PDF documents, presentations, graphics, XML files, and more. An array item is represented as follows:
sequence (string, optional) - The sequence number of the filing, e.g. 1description (string, optional) - Description of the file, e.g. EXHIBIT 31.1documentUrl (string) - URL to the file on SEC.govtype (string, optional) - Type of the file, e.g. EX-32.1, GRAPHIC or 10-Qsize (string, optional) - Size of the file, e.g. 6627216dataFiles (array) - List of data files (filing attachments, exhibits, XBRL files) attached to the filing.
sequence (string) - Sequence number of the file, e.g. 6description (string) - Description of the file, e.g. XBRL INSTANCE DOCUMENTdocumentUrl (string) - URL to the file on SEC.govtype (string, optional) - Type of the file, e.g. EX-101.INS, EX-101.DEF or EX-101.PREsize (string, optional) - Size of the file, e.g. 6627216seriesAndClassesContractsInformation (array) - List of series and classes/contracts information
series (string) - Series ID, e.g. S000001297name (string) - Name of entity, e.g. PRUDENTIAL ANNUITIES LIFE ASSUR CORP VAR ACCT B CL 1 SUB ACCTSclassesContracts (array) - List of classes/contracts. Each list item has the following keys:
classContract (string) - Class/Contract ID, e.g. C000011787name (string) - Name of class/contract entity, e.g. Class Lticker (string) - Ticker class/contract entity, e.g. URTLX13F filings report institutional ownerships. Each 13F filing has an attribute holdings (array). An array item in holdings represents one holding and has the following attributes:
nameOfIssuer (string) - Name of issuer, e.g. MICRON TECHNOLOGY INCtitleOfClass (string) - Title of class, e.g. COMcusip (string) - CUSIP of security, e.g. 98850P109value (integer) - Absolute holding value in $, e.g. 18000. Note: value doesn't have to be multiplied by 1000 anymore. It's done by our API automatically.shrsOrPrnAmt (object)
sshPrnamt (integer) - Shares or PRN AMT, e.g. 345sshPrnamtType (string) - Share/PRN type, e.g. "SH"putCall (string, optional) - Put / Call, e.g. PutinvestmentDiscretion (string) - Investment discretion, e.g. "SOLE"otherManager (string, optional) - Other manager, e.g. 7votingAuthority (object)
Sole (integer) - Sole, e.g. 345Shared (integer) - Shared, e.g. 345None (integer) - None, e.g. 345{
"id": "79ad9e452ea42402df4fe55c636191d6",
"accessionNo": "0001213900-21-032169",
"cik": "1824149",
"ticker": "JOFF",
"companyName": "JOFF Fintech Acquisition Corp.",
"companyNameLong": "JOFF Fintech Acquisition Corp. (Filer)",
"formType": "10-Q",
"description": "Form 10-Q - Quarterly report [Sections 13 or 15(d)]",
"filedAt": "2021-06-11T17:25:44-04:00",
"linkToTxt": "https://www.sec.gov/Archives/edgar/data/1824149/000121390021032169/0001213900-21-032169.txt",
"linkToHtml": "https://www.sec.gov/Archives/edgar/data/1824149/000121390021032169/0001213900-21-032169-index.htm",
"linkToXbrl": "",
"linkToFilingDetails": "https://www.sec.gov/Archives/edgar/data/1824149/000121390021032169/f10q0321_jofffintech.htm",
"entities": [
{
"companyName": "JOFF Fintech Acquisition Corp. (Filer)",
"cik": "1824149",
"irsNo": "852863893",
"stateOfIncorporation": "DE",
"fiscalYearEnd": "1231",
"type": "10-Q",
"act": "34",
"fileNo": "001-40005",
"filmNo": "211012398",
"sic": "6770 Blank Checks"
}
],
"documentFormatFiles": [
{
"sequence": "1",
"description": "QUARTERLY REPORT",
"documentUrl": "https://www.sec.gov/Archives/edgar/data/1824149/000121390021032169/f10q0321_jofffintech.htm",
"type": "10-Q",
"size": "274745"
},
{
"sequence": "2",
"description": "CERTIFICATION",
"documentUrl": "https://www.sec.gov/Archives/edgar/data/1824149/000121390021032169/f10q0321ex31-1_jofffintech.htm",
"type": "EX-31.1",
"size": "12209"
},
{
"sequence": "3",
"description": "CERTIFICATION",
"documentUrl": "https://www.sec.gov/Archives/edgar/data/1824149/000121390021032169/f10q0321ex31-2_jofffintech.htm",
"type": "EX-31.2",
"size": "12220"
},
{
"sequence": "4",
"description": "CERTIFICATION",
"documentUrl": "https://www.sec.gov/Archives/edgar/data/1824149/000121390021032169/f10q0321ex32-1_jofffintech.htm",
"type": "EX-32.1",
"size": "4603"
},
{
"sequence": "5",
"description": "CERTIFICATION",
"documentUrl": "https://www.sec.gov/Archives/edgar/data/1824149/000121390021032169/f10q0321ex32-2_jofffintech.htm",
"type": "EX-32.2",
"size": "4607"
},
{
"sequence": " ",
"description": "Complete submission text file",
"documentUrl": "https://www.sec.gov/Archives/edgar/data/1824149/000121390021032169/0001213900-21-032169.txt",
"type": " ",
"size": "2344339"
}
],
"dataFiles": [
{
"sequence": "6",
"description": "XBRL INSTANCE FILE",
"documentUrl": "https://www.sec.gov/Archives/edgar/data/1824149/000121390021032169/joff-20210331.xml",
"type": "EX-101.INS",
"size": "248137"
},
{
"sequence": "7",
"description": "XBRL SCHEMA FILE",
"documentUrl": "https://www.sec.gov/Archives/edgar/data/1824149/000121390021032169/joff-20210331.xsd",
"type": "EX-101.SCH",
"size": "43550"
},
{
"sequence": "8",
"description": "XBRL CALCULATION FILE",
"documentUrl": "https://www.sec.gov/Archives/edgar/data/1824149/000121390021032169/joff-20210331_cal.xml",
"type": "EX-101.CAL",
"size": "21259"
},
{
"sequence": "9",
"description": "XBRL DEFINITION FILE",
"documentUrl": "https://www.sec.gov/Archives/edgar/data/1824149/000121390021032169/joff-20210331_def.xml",
"type": "EX-101.DEF",
"size": "182722"
},
{
"sequence": "10",
"description": "XBRL LABEL FILE",
"documentUrl": "https://www.sec.gov/Archives/edgar/data/1824149/000121390021032169/joff-20210331_lab.xml",
"type": "EX-101.LAB",
"size": "309660"
},
{
"sequence": "11",
"description": "XBRL PRESENTATION FILE",
"documentUrl": "https://www.sec.gov/Archives/edgar/data/1824149/000121390021032169/joff-20210331_pre.xml",
"type": "EX-101.PRE",
"size": "186873"
}
],
"seriesAndClassesContractsInformation": [],
"periodOfReport": "2021-03-31",
"effectivenessDate": "2021-03-31"
}
Let me know how I can improve the library or if you have any feature suggestions. I'm happy to implement them.
Just open a new issue on github here: https://github.com/janlukasschroeder/sec-api/issues
FAQs
sec.gov EDGAR API Wrapper
We found that sec-api demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
GitHub removed 27 malicious pull requests attempting to inject harmful code across multiple open source repositories, in another round of low-effort attacks.
Security News
RubyGems.org has added a new "maintainer" role that allows for publishing new versions of gems. This new permission type is aimed at improving security for gem owners and the service overall.
Security News
Node.js will be enforcing stricter semver-major PR policies a month before major releases to enhance stability and ensure reliable release candidates.