NAV Navigation
Shell HTTP JavaScript Node.js Ruby Python Java Go

SEC 8-K Filings v1.0

Scroll down for code samples, example requests and responses. Select a language for code samples from the tabs above or the mobile navigation menu.

Base URLs:

Email: API Support Web: API Support

8-k

list

Code samples

# You can also use wget
curl -X GET http://api.risklio.com/v1/8k \
  -H 'Accept: application/json'

GET http://api.risklio.com/v1/8k HTTP/1.1
Host: api.risklio.com
Accept: application/json

var headers = {
  'Accept':'application/json'

};

$.ajax({
  url: 'http://api.risklio.com/v1/8k',
  method: 'get',

  headers: headers,
  success: function(data) {
    console.log(JSON.stringify(data));
  }
})

const fetch = require('node-fetch');

const headers = {
  'Accept':'application/json'

};

fetch('http://api.risklio.com/v1/8k',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Accept' => 'application/json'
}

result = RestClient.get 'http://api.risklio.com/v1/8k',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/json'
}

r = requests.get('http://api.risklio.com/v1/8k', params={

}, headers = headers)

print r.json()

URL obj = new URL("http://api.risklio.com/v1/8k");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "http://api.risklio.com/v1/8k", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /8k

Get last 10 SEC 8-K Filings

Example responses

200 Response

[
  {
    "filing_id": 0,
    "created_at": "2019-03-10T19:59:25Z",
    "accession_number": "string",
    "form_type": {
      "type": "string",
      "description": "string",
      "link": "string",
      "last_updated": "string",
      "sec_number": "string",
      "topics": "string"
    },
    "document_count": 0,
    "date_filed": "2019-03-10",
    "date_changed": "2019-03-10",
    "items": [
      {
        "section_number": 0,
        "subsection_number": 0,
        "section": "string",
        "item": "string",
        "item_name": "string"
      }
    ],
    "filers": [
      {
        "form_type": {
          "type": "string",
          "description": "string",
          "link": "string",
          "last_updated": "string",
          "sec_number": "string",
          "topics": "string"
        },
        "sec_act": "string",
        "file_number": "string",
        "film_number": "string",
        "company": {
          "name": "string",
          "cik": "string",
          "irs_numer": "string",
          "fiscal_year_end": "string",
          "state_incorporation": "string",
          "addresses": [
            {
              "type": "BUSINESS",
              "street_1": "string",
              "street_2": "string",
              "city": "string",
              "state": "string",
              "zip": 0,
              "phone": "string",
              "processed_file": "string"
            }
          ],
          "industries": [
            {
              "sic_code": "string",
              "devision": "string",
              "industry": "string"
            }
          ],
          "historic_names": [
            {
              "until_date": "2019-03-10",
              "name": "string"
            }
          ]
        }
      }
    ],
    "documents": [
      {
        "created_at": "2019-03-10T19:59:25Z",
        "type": "string",
        "content_type": "string",
        "description": "string",
        "file_name": "string",
        "sequence": 0,
        "sha1": "string",
        "processed_file": "http://example.com"
      }
    ]
  }
]

Responses

Status Meaning Description Schema
200 OK Success 8k-filings
500 Internal Server Error Server error None

Schemas

8k-filing

{
  "filing_id": 0,
  "created_at": "2019-03-10T19:59:25Z",
  "accession_number": "string",
  "form_type": {
    "type": "string",
    "description": "string",
    "link": "string",
    "last_updated": "string",
    "sec_number": "string",
    "topics": "string"
  },
  "document_count": 0,
  "date_filed": "2019-03-10",
  "date_changed": "2019-03-10",
  "items": [
    {
      "section_number": 0,
      "subsection_number": 0,
      "section": "string",
      "item": "string",
      "item_name": "string"
    }
  ],
  "filers": [
    {
      "form_type": {
        "type": "string",
        "description": "string",
        "link": "string",
        "last_updated": "string",
        "sec_number": "string",
        "topics": "string"
      },
      "sec_act": "string",
      "file_number": "string",
      "film_number": "string",
      "company": {
        "name": "string",
        "cik": "string",
        "irs_numer": "string",
        "fiscal_year_end": "string",
        "state_incorporation": "string",
        "addresses": [
          {
            "type": "BUSINESS",
            "street_1": "string",
            "street_2": "string",
            "city": "string",
            "state": "string",
            "zip": 0,
            "phone": "string",
            "processed_file": "string"
          }
        ],
        "industries": [
          {
            "sic_code": "string",
            "devision": "string",
            "industry": "string"
          }
        ],
        "historic_names": [
          {
            "until_date": "2019-03-10",
            "name": "string"
          }
        ]
      }
    }
  ],
  "documents": [
    {
      "created_at": "2019-03-10T19:59:25Z",
      "type": "string",
      "content_type": "string",
      "description": "string",
      "file_name": "string",
      "sequence": 0,
      "sha1": "string",
      "processed_file": "http://example.com"
    }
  ]
}

Properties

Name Type Required Restrictions Description
filing_id integer(int64) false none none
created_at string(date-time) false none none
accession_number string false none none
form_type form_type false none none
document_count integer(int64) false none none
date_filed string(date) false none none
date_changed string(date) false none none
items [item] false none none
filers [filer] false none none
documents [document] false none none

form_type

{
  "type": "string",
  "description": "string",
  "link": "string",
  "last_updated": "string",
  "sec_number": "string",
  "topics": "string"
}

Properties

Name Type Required Restrictions Description
type string false none none
description string false none none
link string false none none
last_updated string false none none
sec_number string false none none
topics string false none none

item

{
  "section_number": 0,
  "subsection_number": 0,
  "section": "string",
  "item": "string",
  "item_name": "string"
}

Properties

Name Type Required Restrictions Description
section_number integer false none none
subsection_number integer false none none
section string false none none
item string false none none
item_name string false none none

filer

{
  "form_type": {
    "type": "string",
    "description": "string",
    "link": "string",
    "last_updated": "string",
    "sec_number": "string",
    "topics": "string"
  },
  "sec_act": "string",
  "file_number": "string",
  "film_number": "string",
  "company": {
    "name": "string",
    "cik": "string",
    "irs_numer": "string",
    "fiscal_year_end": "string",
    "state_incorporation": "string",
    "addresses": [
      {
        "type": "BUSINESS",
        "street_1": "string",
        "street_2": "string",
        "city": "string",
        "state": "string",
        "zip": 0,
        "phone": "string",
        "processed_file": "string"
      }
    ],
    "industries": [
      {
        "sic_code": "string",
        "devision": "string",
        "industry": "string"
      }
    ],
    "historic_names": [
      {
        "until_date": "2019-03-10",
        "name": "string"
      }
    ]
  }
}

Properties

Name Type Required Restrictions Description
form_type form_type false none none
sec_act string false none none
file_number string false none none
film_number string false none none
company company false none none

document

{
  "created_at": "2019-03-10T19:59:25Z",
  "type": "string",
  "content_type": "string",
  "description": "string",
  "file_name": "string",
  "sequence": 0,
  "sha1": "string",
  "processed_file": "http://example.com"
}

Properties

Name Type Required Restrictions Description
created_at string(date-time) false none Date/Time the file was processed
type string false none Type of document
content_type string false none MIME Type of original file
description string false none Description of file
file_name string false none Name of the original file
sequence integer false none Position of document in filing
sha1 string false none SHA1 checksum of original content
processed_file string(uri) false none Link to processed file

company

{
  "name": "string",
  "cik": "string",
  "irs_numer": "string",
  "fiscal_year_end": "string",
  "state_incorporation": "string",
  "addresses": [
    {
      "type": "BUSINESS",
      "street_1": "string",
      "street_2": "string",
      "city": "string",
      "state": "string",
      "zip": 0,
      "phone": "string",
      "processed_file": "string"
    }
  ],
  "industries": [
    {
      "sic_code": "string",
      "devision": "string",
      "industry": "string"
    }
  ],
  "historic_names": [
    {
      "until_date": "2019-03-10",
      "name": "string"
    }
  ]
}

Properties

Name Type Required Restrictions Description
name string false none none
cik string false none none
irs_numer string false none none
fiscal_year_end string false none none
state_incorporation string false none none
addresses [address] false none none
industries [industry] false none none
historic_names [historic_name] false none none

address

{
  "type": "BUSINESS",
  "street_1": "string",
  "street_2": "string",
  "city": "string",
  "state": "string",
  "zip": 0,
  "phone": "string",
  "processed_file": "string"
}

Properties

Name Type Required Restrictions Description
type string false none none
street_1 string false none none
street_2 string false none none
city string false none none
state string false none none
zip integer false none none
phone string false none none
processed_file string(url) false none none

Enumerated Values

Property Value
type BUSINESS
type MAIL

historic_name

{
  "until_date": "2019-03-10",
  "name": "string"
}

Properties

Name Type Required Restrictions Description
until_date string(date) false none none
name string false none none

industry

{
  "sic_code": "string",
  "devision": "string",
  "industry": "string"
}

Properties

Name Type Required Restrictions Description
sic_code string false none none
devision string false none none
industry string false none none

8k-filings

[
  {
    "filing_id": 0,
    "created_at": "2019-03-10T19:59:25Z",
    "accession_number": "string",
    "form_type": {
      "type": "string",
      "description": "string",
      "link": "string",
      "last_updated": "string",
      "sec_number": "string",
      "topics": "string"
    },
    "document_count": 0,
    "date_filed": "2019-03-10",
    "date_changed": "2019-03-10",
    "items": [
      {
        "section_number": 0,
        "subsection_number": 0,
        "section": "string",
        "item": "string",
        "item_name": "string"
      }
    ],
    "filers": [
      {
        "form_type": {
          "type": "string",
          "description": "string",
          "link": "string",
          "last_updated": "string",
          "sec_number": "string",
          "topics": "string"
        },
        "sec_act": "string",
        "file_number": "string",
        "film_number": "string",
        "company": {
          "name": "string",
          "cik": "string",
          "irs_numer": "string",
          "fiscal_year_end": "string",
          "state_incorporation": "string",
          "addresses": [
            {
              "type": "BUSINESS",
              "street_1": "string",
              "street_2": "string",
              "city": "string",
              "state": "string",
              "zip": 0,
              "phone": "string",
              "processed_file": "string"
            }
          ],
          "industries": [
            {
              "sic_code": "string",
              "devision": "string",
              "industry": "string"
            }
          ],
          "historic_names": [
            {
              "until_date": "2019-03-10",
              "name": "string"
            }
          ]
        }
      }
    ],
    "documents": [
      {
        "created_at": "2019-03-10T19:59:25Z",
        "type": "string",
        "content_type": "string",
        "description": "string",
        "file_name": "string",
        "sequence": 0,
        "sha1": "string",
        "processed_file": "http://example.com"
      }
    ]
  }
]

Properties

Name Type Required Restrictions Description
anonymous [8k-filing] false none none

Error

{
  "code": 0,
  "message": "string"
}

Properties

Name Type Required Restrictions Description
code integer(int32) true none none
message string true none none