Skip to main content
Skip table of contents

GetEdgarFilingList

Description

Returns an array of SEC filings filtered by input parameters. When any of the parameters is missed, then the default value is used.

Input Parameters

Parameter

Description

apiKey (string)

To use the Q4 API, you need to have an application key. We use this to track API usage. Currently, the use of the API is allowed only with prior permission. Requests for API keys are reviewed by staff. Please get in touch with support to get the API Key.

pageNumber (int)

When paging is used, specify the page number to return. It is 0-based.

pageSize (int)

When pageSize is greater the 0, the paging is enabled. The default is 0 (paging disabled).

symbol (string)

Specifies that returned data records have to include associated tags.

exchange (string)

Specifies the company indice symbol that was used to do SEC filing.

formGroupIdList (string)

Specifies the comma-separated string of Form Group Id(s) that should be used to filter SEC filings. The default value is "" and the filter by FormGroup won't be applied.

year (int)

Specifies the year for which financial reports should be returned. When it is not provided, the result will not be filtered by year.

excludeNoDocuments (bool)

Specifies if SEC filings with no documents need to be populated.

Sample URL

https://domain.com/feed/SECFiling.svc/GetEdgarFilingList?apiKey=c34993dcba1942418d97656f3ed00979&pageNumber=0&pageSize=20&IncludeTags=true&symbol=AEM&exchange=NYSE&formGroupIdList=&year=2012&excludeNoDocuments=false

Sample Request

JSON
var data = {
    apiKey: apiKey,
    pageNumber: 0,
    pageSize: 20,
    IncludeTags: true,
    symbol: "AEM",
    exchange: "NYSE",
    formGroupIdList: GroupIdListId,
    year: Year,
    excludeNoDocuments: false
}

$.ajax({
    type: "GET",
    url: domainName + "/feed/SECFiling.svc/GetEdgarFilingList",
    data: data,
    dataType: "json",
    success: OnLoadSECListSuccess,
    error: OnLoadSECListError
});

Sample Response

JSON
{
    "GetEdgarFilingListResult": [{
            "DocumentList": [{
                    "CreateDate": "/Date(1327444086617-0600)/",
                    "DocumentType": "ORIG",
                    "FilingDocumentId": 934944,
                    "Url": ""
                },
                {
                    "CreateDate": "/Date(1327444086617-0600)/",
                    "DocumentType": "HTML",
                    "FilingDocumentId": 934945,
                    "Url": ""
                },
                {
                    "CreateDate": "/Date(1327444086617-0600)/",
                    "DocumentType": "RTF",
                    "FilingDocumentId": 934946,
                    "Url": "http://cdn.domain.com/b6225aab-0205-4693-b732-4a44dc5c823e.rtf"
                },
                {
                    "CreateDate": "/Date(1327444086617-0600)/",
                    "DocumentType": "CONVPDF",
                    "FilingDocumentId": 934947,
                    "Url": "http://cdn.domain.com/0eee2b55-3445-4574-b55f-5082bd3cf058.pdf"
                },
                {
                    "CreateDate": "/Date(1327444086617-0600)/",
                    "DocumentType": "CONVTEXT",
                    "FilingDocumentId": 934948,
                    "Url": ""
                },
                {
                    "CreateDate": "/Date(1327444086617-0600)/",
                    "DocumentType": "XLS",
                    "FilingDocumentId": 934949,
                    "Url": "http://cdn.domain.com/513e04b9-7d86-4f79-80ba-ecddfd5a0afd.xls"
                }
            ],
            "EdgarFilingId": 237084,
            "FilingAgentId": 93513,
            "FilingAgentName": "MERRILL CORP-MD/FA",
            "FilingDate": "/Date(1327384800000-0600)/",
            "FilingDescription": "Report of Foreign Issuer",
            "FilingId": 8350578,
            "FilingTypeId": 125,
            "FilingTypeMnemonic": "6-K",
            "LinkToDetailPage": "/English/Our-Company/Edgar-SEC-List/SEC-Details/default.aspx?FilingId=8350578",
            "ReceivedDate": "/Date(1327447690000-0600)/",
            "ReportPersonId": null,
            "ReportPersonName": null,
            "StockExchange": "NYSE",
            "StockSymbol": "AEM"
        },
        {
            "DocumentList": [{
                    "CreateDate": "/Date(1326225082910-0600)/",
                    "DocumentType": "ORIG",
                    "FilingDocumentId": 934730,
                    "Url": ""
                },
                {
                    "CreateDate": "/Date(1326225082910-0600)/",
                    "DocumentType": "HTML",
                    "FilingDocumentId": 934731,
                    "Url": ""
                },
                {
                    "CreateDate": "/Date(1326225082910-0600)/",
                    "DocumentType": "RTF",
                    "FilingDocumentId": 934732,
                    "Url": "http://cdn.domain.com/44415410-e1b6-4b94-ba61-48045e3e2c85.rtf"
                },
                {
                    "CreateDate": "/Date(1326225082910-0600)/",
                    "DocumentType": "CONVPDF",
                    "FilingDocumentId": 934733,
                    "Url": "http://cdn.domain.com/1976bc80-8db8-470f-8de5-5c0dbc3e477c.pdf"
                },
                {
                    "CreateDate": "/Date(1326225082910-0600)/",
                    "DocumentType": "XLS",
                    "FilingDocumentId": 934734,
                    "Url": "http://cdn.domain.com/fc6a2e7d-6338-427d-9b03-46119e6dc096.xls"
                }
            ],
            "EdgarFilingId": 237048,
            "FilingAgentId": 62887,
            "FilingAgentName": "BLACKROCK ADVISORS LLC",
            "FilingDate": "/Date(1326175200000-0600)/",
            "FilingDescription": "Amended Statement of Ownership",
            "FilingId": 8331615,
            "FilingTypeId": 346,
            "FilingTypeMnemonic": "SC 13G/A",
            "LinkToDetailPage": "/English/Our-Company/Edgar-SEC-List/SEC-Details/default.aspx?FilingId=8331615",
            "ReceivedDate": "/Date(1326228666000-0600)/",
            "ReportPersonId": null,
            "ReportPersonName": null,
            "StockExchange": "NYSE",
            "StockSymbol": "AEM"
        }
    ]
} 

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.