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

SEC Watch Research Platform

Custom SEC Filing Feeds

SEC Watch brings transparency to nearly 800,000 annual SEC Filings.