SEC Filings API Reference

Free Trial ➡

SEC filings data

API Endpoint
https://api.benzinga.com/api/v1/sec
Response Content-Types

application/json

Schemes

https

Version

1.0.0

Authentication

token authentication

Type:
apiKey
Name:
token
In:
query

Playground

Endpoints

GET /insider_transactions/filings

Returns insider transactions data (SEC Form 4)

Parameters

NameTypeLocationDescription
accession_numberstringquery

Accession Number of the filling - Unique identifier assigned automatically to an accepted submission by the SEC. This will be same for all transaction (entries) of that filling. Supports with and without dashes.

datestring (YYYY-MM-DD)query

Date to query for data. Shorthand for date_from and date_to if they are the same. Defaults for latest.

date_fromstring (YYYY-MM-DD)query

Date to query from point in time.

date_tostring (YYYY-MM-DD)query

Date to query to point in time.

fieldsstring[]query

A comma (,) separated list of returned fields.

pagesizeinteger 50query

Number of results returned. Limit 1000

pageintegerquery

Page offset.

search_keysstring (csv)query

One or more security symbols separated by a comma. Maximum 50 securities. Security identifiers must be in the format of ticker symbols, only for US-listed equities.

updated_sincenumber (double)query

Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated.

Timestamp may also be in python format to include millisecond updates.

Responses

CodeModelDescription
200 OKinsider_transactions_filings

success

Response (200 OK)

[
  {
    "id": "string",
    "accession_number": "string",
    "company_cik": "string",
    "company_name": "string",
    "company_symbol": "string",
    "filing_date": "string (YYYY-MM-DD)",
    "footnotes": [
      {
        "id": "string",
        "text": "string"
      }
    ],
    "form_type": "string",
    "html_url": "string",
    "owner": {
      "insider_cik": "string",
      "insider_name": "string",
      "insider_title": "string",
      "is_director": "boolean",
      "is_officer": "boolean",
      "is_other_relation": "boolean",
      "is_ten_percent_owner": "boolean",
      "raw_signature": "string"
    },
    "transactions": [
      {
        "is_derivative": "boolean",
        "acquired_or_disposed": "string",
        "conversion_exercise_price_derivative": "string",
        "date_deemed_execution": "string",
        "date_exercisable": "string (YYYY-MM-DD)",
        "date_expiration": "string (YYYY-MM-DD)",
        "date_transaction": "string (YYYY-MM-DD)",
        "post_transaction_quantity": "integer",
        "price_per_share": "string (float)",
        "security_title": "string",
        "shares": "integer",
        "transaction_code": "string",
        "transaction_id": "string",
        "underlying_security_title": "string",
        "underlying_shares": "integer",
        "voluntarily_reported": "string"
      }
    ],
    "updated": "integer"
  }
]

Models

insider_transactions_filings: object

PropertyTypeDescription
idstring

Benzinga-generated unique identifier for this individual insider transaction.

accession_numberstring

Accession Number of the filling - Unique identifier assigned automatically to an accepted submission by the SEC. This will be same for all transaction (entries) of that filling.

company_cikstring

Central Index Key (CIK) for the filing company.

company_namestring

Name of the company.

company_symbolstring

Primary (i.e. common stock ticker) symbol of the company whose securities are getting purchased / sold.

filing_datestring (YYYY-MM-DD)

Date of the SEC filing.

footnotesobject[]-
footnotes[].idstring

Footnote ID. (i.e. 'F1')

footnotes[].textstring

Footnote explainations of the responses on the form.

form_typestring

SEC form type.

html_urlstring

URL of the original SEC Form.

ownerobject-
owner.insider_cikstring

Central Index Key (CIK) of the reporting insider.

owner.insider_namestring

Name of the reporting insider.

owner.insider_titlestring

Official title of the insider.

owner.is_directorboolean

A boolean signifying the relationship of Reporting Person(s) to Issuer (true/false)

owner.is_officerboolean

A boolean signifying the relationship of Reporting Person(s) to Issuer (true/false)

owner.is_other_relationboolean

A boolean signifying the relationship of Reporting Person(s) to Issuer (true/false)

owner.is_ten_percent_ownerboolean

A boolean signifying the relationship of Reporting Person(s) to Issuer (true/false)

owner.raw_signaturestring

Signature of reporting person.

transactionsobject[]

All derivative and non-derivative transactions associated with the filing.

transactions[].is_derivativeboolean

If the transaction is a derivative

transactions[].acquired_or_disposedstring

Code denoting whether the security was acquired (A) or disposed (D).

transactions[].conversion_exercise_price_derivativestring

Conversion or exercise price of derivative security.

transactions[].date_deemed_executionstring

The deemed execution date (if any), had there not been a directly identifiable date.

transactions[].date_exercisablestring (YYYY-MM-DD)

The date in which the derivative security may be exercised.

transactions[].date_expirationstring (YYYY-MM-DD)

The expiration date of the derivative security.

transactions[].date_transactionstring (YYYY-MM-DD)

The date of the transaction.

transactions[].post_transaction_quantityinteger

Quantity of shares remaining after the transaction.

transactions[].price_per_sharestring (float)

Price of each individual share transacted.

transactions[].security_titlestring

The name of the security transacted.

transactions[].sharesinteger

The number of shares involved in the transaction.

transactions[].transaction_codestring

Code describing the transaction. (https://www.sec.gov/edgar/searchedgar/ownershipformcodes.html)

transactions[].transaction_idstring

Unique ID of the transaction.

transactions[].underlying_security_titlestring

The name of the security transacted.

transactions[].underlying_sharesinteger

The number of shares involved in the subject transaction.

transactions[].voluntarily_reportedstring

Signifies whether the transaction is reported earlier than required (true/false)

updatedinteger

Last updated timestamp, UTC.

Structure (JSON)
{
  "id": "string",
  "accession_number": "string",
  "company_cik": "string",
  "company_name": "string",
  "company_symbol": "string",
  "filing_date": "string (YYYY-MM-DD)",
  "footnotes": [
    {
      "id": "string",
      "text": "string"
    }
  ],
  "form_type": "string",
  "html_url": "string",
  "owner": {
    "insider_cik": "string",
    "insider_name": "string",
    "insider_title": "string",
    "is_director": "boolean",
    "is_officer": "boolean",
    "is_other_relation": "boolean",
    "is_ten_percent_owner": "boolean",
    "raw_signature": "string"
  },
  "transactions": [
    {
      "is_derivative": "boolean",
      "acquired_or_disposed": "string",
      "conversion_exercise_price_derivative": "string",
      "date_deemed_execution": "string",
      "date_exercisable": "string (YYYY-MM-DD)",
      "date_expiration": "string (YYYY-MM-DD)",
      "date_transaction": "string (YYYY-MM-DD)",
      "post_transaction_quantity": "integer",
      "price_per_share": "string (float)",
      "security_title": "string",
      "shares": "integer",
      "transaction_code": "string",
      "transaction_id": "string",
      "underlying_security_title": "string",
      "underlying_shares": "integer",
      "voluntarily_reported": "string"
    }
  ],
  "updated": "integer"
}