ABOUT SEC WATCH

OVERVIEW

DEMOS AND VIDEOS

API

CONTACT/FEEDBACK

SEC Watch API: Access to Edgar SEC Filings

Introduction

API Call: getFilings

API Call: getFormTypes

Introduction

The SEC Watch API was designed to make it easy to find SEC Filings filed through SEC's (the U.S. Security and Exchange Commission) Edgar system. Filings can be found by filing type, company, or combination of filing type and company. All API calls have the following syntax, with the possible [CALL] listed below

http://secwatch.com/s/api?call=[CALL]&[PARAMETER1]=[PARAMETER1_VALUE]...

All responses are in XML format, with examples below. We are very open to feedback. Please don't hesitate to contact us with questions or suggestions

getFilings

The getFilings API call returns the last 100 SEC Filings sorted by date filed. If a form_typeid is specified, only filings with the given form type are returned. A ticker symbol can also be specificed to filter by company.

Parameters:

Parameters	Required	Description	Example
form_typeid	no	Use the getFormTypes API call to find the appropriate form_typeid (10-K, 10-Q, 8-K, etc.)	287
ticker	no	View filings for a company specified by a ticker symbol. This parameter can be used in combination with the form_typeid (ie. Google's 10-K filings or Apple's 8-K filings). Leave the form_typeid parameter blank to get all the filings for a particular company.	aapl

Sample API Call (All latest SEC Filings):

http://secwatch.com/s/api?call=getFilings

Sample API Response:

<response>
  <filing>
    <form_name>Form SC 13G/A</form_name>
    <file_date>Fri, 9 Jan 2009 00:00:00 EST</file_date>
    <file_date_formatted>01-09-09</file_date_formatted>
    <company_name>MID AMERICA APARTMENT COMMUNITIES INC</company_name>
    <url>http://secwatch.com/filings/view.jsp?formid=1869884</url>
  </filing>
  <filing>
    <form_name>Form SC 13G/A</form_name>
    <file_date>Fri, 9 Jan 2009 00:00:00 EST</file_date>
    <file_date_formatted>01-09-09</file_date_formatted>
    <company_name>MEXICO EQUITY & INCOME FUND INC</company_name>
    <url>http://secwatch.com/filings/view.jsp?formid=1869881</url>
  </filing>
    ...
  <filing>
    <form_name>Form SC 13G/A</form_name>
    <file_date>Fri, 9 Jan 2009 00:00:00 EST</file_date>
    <file_date_formatted>01-09-09</file_date_formatted>
    <company_name>TRUMP ENTERTAINMENT RESORTS, INC.</company_name>
    <url>http://secwatch.com/filings/view.jsp?formid=1869955</url>
  </filing>
</response>

Sample API Call (Latest filings for IBM):

http://secwatch.com/s/api?call=getFilings&ticker=ibm

Sample API Response:

<response>
  <filing>
    <form_name>Form 4</form_name>
    <file_date>Fri, 2 Jan 2009 00:00:00 EST</file_date>
    <file_date_formatted>01-02-09</file_date_formatted>
    <company_name>INTERNATIONAL BUSINESS MACHINES CORP</company_name>
    <url>http://secwatch.com/filings/view.jsp?formid=1852659</url>
  </filing>
  <filing>
    <form_name>Form 4</form_name>
    <file_date>Fri, 2 Jan 2009 00:00:00 EST</file_date>
    <file_date_formatted>01-02-09</file_date_formatted>
    <company_name>INTERNATIONAL BUSINESS MACHINES CORP</company_name>
    <url>http://secwatch.com/filings/view.jsp?formid=1852658</url>
  </filing>
    ...
  <filing>
    <form_name>Form 4</form_name>
    <file_date>Fri, 2 Jan 2009 00:00:00 EST</file_date>
    <file_date_formatted>01-02-09</file_date_formatted>
    <company_name>INTERNATIONAL BUSINESS MACHINES CORP</company_name>
    <url>http://secwatch.com/filings/view.jsp?formid=1852657</url>
  </filing>
</response>

Sample API Call (Latest 8-K Filings):

http://secwatch.com/s/api?call=getFilings&form_typid=287

Sample API Response:

<response>
  <filing>
    <form_name>Form 8-K</form_name>
    <file_date>Fri, 9 Jan 2009 00:00:00 EST</file_date>
    <file_date_formatted>01-09-09</file_date_formatted>
    <company_name>ev3 Inc.</company_name>
    <url>http://secwatch.com/filings/view.jsp?formid=1868736</url>
  </filing>
  <filing>
    <form_name>Form 8-K</form_name>
    <file_date>Fri, 9 Jan 2009 00:00:00 EST</file_date>
    <file_date_formatted>01-09-09</file_date_formatted>
    <company_name>Zep Inc.</company_name>
    <url>http://secwatch.com/filings/view.jsp?formid=1868735</url>
  </filing>
    ...
  <filing>
    <form_name>Form 8-K</form_name>
    <file_date>Fri, 9 Jan 2009 00:00:00 EST</file_date>
    <file_date_formatted>01-09-09</file_date_formatted>
    <company_name>ZOLTEK COMPANIES INC</company_name>
    <url>http://secwatch.com/filings/view.jsp?formid=1868734</url>
  </filing>
</response>

Sample API Call (Latest 8-K Filings for Apple Inc.):

http://secwatch.com/s/api?call=getFilings&form_typid=287&ticker=aapl

Sample API Response:

<response>
  <filing>
    <form_name>Form 8-K</form_name>
    <file_date>Tue, 21 Oct 2008 00:00:00 EDT</file_date>
    <file_date_formatted>10-21-08</file_date_formatted>
    <company_name>APPLE INC</company_name>
    <url>http://secwatch.com/filings/view.jsp?formid=1716855</url>
  </filing>
  <filing>
    <form_name>Form 8-K</form_name>
    <file_date>Tue, 26 Aug 2008 00:00:00 EDT</file_date>
    <file_date_formatted>08-26-08</file_date_formatted>
    <company_name>APPLE INC</company_name>
    <url>http://secwatch.com/filings/view.jsp?formid=231283</url>
  </filing>
    ...
  <filing>
    <form_name>Form 8-K</form_name>
    <file_date>Mon, 21 Jul 2008 00:00:00 EDT</file_date>
    <file_date_formatted>07-21-08</file_date_formatted>
    <company_name>APPLE INC</company_name>
    <url>http://secwatch.com/filings/view.jsp?formid=231282</url>
  </filing>
</response>

getFormTypes

The 'getFormTypes' API call lists all form types, a description for each form type, and the form_typeid. The form_typeid is required in several API calls (ie. 10-K filings for Google).

Sample API Call:

http://secwatch.com/s/api?call=getFormTypes

Sample API Response:

<response>
  <form_type>
    <name>10-K</name>
    <description>10-K</name>
    <form_typeid>23</name>
  </form_type>
  <form_type>
    <name>10-K</name>
    <description>10-K</name>
    <form_typeid>23</name>
  </form_type>
  ...
  <form_type>
    <name>10-K</name>
    <description>10-K</name>
    <form_typeid>23</name>
  </form_type>
</response>

We are very open to feedback. Please don't hesitate to contact us with questions or suggestions

Create a FREE SEC Watch account

Create Email Alerts

Manage SEC Filing Research

Create Portfolios

Email:

Create Password:

Yes, please subscribe me to the SEC Watch Daily Brief: A recap of the days most important SEC Filings. View Sample

By clicking on 'Create Account' below you are agreeing to the End User License Agreement and the SEC Watch Terms of Service.

LATEST FORTUNE 500 FILINGS

SEPARATE ACCOUNT VA W files N-30D (Initial annual and semi-annual reports mailed to investment company shareholders) Filed

ROYAL BANK OF CANADA \ files 424B2 (Prospectus) Filed

GAMCO MATHERS FUND files N-CSRS (Certified semi-annual shareholder report of registered management investment companies) Filed

SEPARATE ACCOUNT VA P files N-30D (Initial annual and semi-annual reports mailed to investment company shareholders) Filed

MODERN WOODMEN OF AMERICA VARIABLE ACCOUNT files N-30B-2 (Periodic and interim reports mailed to investment company shareholders) Filed

Avior Computing CORP files D/A (Filing D (Amendment)) Filed

HALLIBURTON CO files 8-K (Events or Changes Between Quarterly Reports) Filed

BLACKROCK INTERNATIONAL VALUE TRUST files N-CSR (Certified annual shareholder report of registered management investment companies) Filed

METLIFE ADVISERS LLC files 13F-NT/A (Initial Quarterly Form 13F Notice Report filed by institutional managers (Amendment)) Filed

GOLDMAN SACHS TRUST files 497 (Definitive materials) Filed

VIEW SEC FILING DASHBOARD