Form 4

GET

/stocks/filings/vX/form-4

This endpoint is free to use during the early-access beta period. Features may change or move to different plans later.

Retrieve SEC Form 4 filings that disclose all changes in beneficial ownership by corporate insiders. These must be filed within two business days of any transaction (purchases, sales, option exercises, grants, gifts, etc.) and include detailed transaction data such as dates, prices, share amounts, and transaction codes.

Use Cases: Real-time insider trading monitoring, management confidence analysis, large trade detection, regulatory and Section 16 compliance tracking, and historical insider behavior studies.

Stocks BasicFree

Stocks Starter$29/mo

Stocks Developer$79/mo

Stocks Advanced$199/mo

Stocks BasicFree

Stocks Starter$29/mo

Stocks Developer$79/mo

Stocks Advanced$199/mo

Plan AccessIncluded in all Stocks plans

Stocks BasicFree

Updated daily

Stocks Starter$29/mo

Updated daily

Stocks Developer$79/mo

Updated daily

Stocks Advanced$199/mo

Updated daily

Stocks BasicFree

Updated daily

Stocks Starter$29/mo

Updated daily

Stocks Developer$79/mo

Updated daily

Stocks Advanced$199/mo

Updated daily

Plan RecencyUpdated daily

Plan HistoryNot applicable to this endpoint

Query Parameters

issuer_cik

string

SEC Central Index Key of the issuer company (10 digits, zero-padded).

owner_cik

string

SEC Central Index Key of the reporting owner (10 digits, zero-padded).

tickers

string

Filter for arrays that contain the value.

form_type

string

SEC form type ('4' for standard filing, '4/A' for amendments).

filing_date

string

Date when the filing was submitted to the SEC (formatted as YYYY-MM-DD). Value must be formatted 'yyyy-mm-dd'.

transaction_code

string

SEC transaction code indicating the type of transaction (e.g., 'P' for purchase, 'S' for sale, 'A' for grant/award, 'M' for exercise/conversion).

limit

integer

Limit the maximum number of results returned. Defaults to '100' if not specified. The maximum allowed limit is '10000'.

sort

string

A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'filing_date' if not specified. The sort order defaults to 'desc' if not specified.

Response Attributes

next_url

string

optional

If present, this value can be used to fetch the next page.

request_id

string

A request id assigned by the server.

results

array (object)

The results for this request.

accession_number

string

optional

Unique SEC accession number for the filing (e.g., '0001209191-25-012345').

aff_10b5_one

boolean

optional

Whether the transaction was made pursuant to a Rule 10b5-1 trading plan.

date_of_original_submission

string

optional

Date of the original filing submission for amendment filings (4/A). Null for standard filings (formatted as YYYY-MM-DD).

deemed_execution_date

string

optional

Deemed execution date if different from transaction date (formatted as YYYY-MM-DD).

direct_or_indirect

string

optional

Whether ownership is direct ('D') or indirect ('I').

equity_swap_involved

boolean

optional

Whether an equity swap was involved in the transaction.

exercise_date

string

optional

Date exercisable for derivative securities (formatted as YYYY-MM-DD).

exercise_price

number

optional

Exercise or conversion price of derivative securities in USD.

expiration_date

string

optional

Expiration date for derivative securities (formatted as YYYY-MM-DD).

filing_date

string

optional

Date when the filing was submitted to the SEC (formatted as YYYY-MM-DD).

filing_url

string

optional

Direct URL to the filing on the SEC EDGAR website.

footnotes

array (object)

optional

List of footnotes from the filing that are relevant to this row, each with an id and description.

form_type

string

optional

SEC form type ('4' for standard filing, '4/A' for amendments).

is_director

boolean

optional

Whether the reporting owner is a director of the issuer.

is_officer

boolean

optional

Whether the reporting owner is an officer of the issuer.

is_other

boolean

optional

Whether the reporting owner has another relationship with the issuer.

is_ten_percent_owner

boolean

optional

Whether the reporting owner holds 10% or more of a class of equity securities.

issuer_cik

string

optional

SEC Central Index Key of the issuer company (10 digits, zero-padded).

issuer_name

string

optional

Name of the issuer company as reported in the filing.

nature_of_ownership

string

optional

Nature of indirect ownership (e.g., 'By Trust', 'By Spouse').

not_subject_to_section_16

boolean

optional

Whether the reporting owner is not subject to Section 16 of the Securities Exchange Act.

officer_title

string

optional

Title of the officer, if the reporting owner is an officer.

owner_cik

string

optional

SEC Central Index Key of the reporting owner (10 digits, zero-padded).

owner_name

string

optional

Name of the reporting owner (individual or entity).

period_of_report

string

optional

Date of the event triggering the filing (formatted as YYYY-MM-DD).

record_type

string

optional

Type of record in the filing (e.g., 'transaction', 'holding').

remarks

string

optional

Additional remarks included in the filing.

security_title

string

optional

Title or description of the security (e.g., 'Common Stock', 'Stock Option').

security_type

string

optional

Type of security ('non-derivative' or 'derivative').

shares_owned_following_transaction

number

optional

Total shares beneficially owned after the transaction.

tickers

array (string)

optional

A list of ticker symbols for the issuer company. Multiple symbols may indicate different share classes.

transaction_acquired_disposed

string

optional

Whether shares were acquired ('A') or disposed of ('D').

transaction_code

string

optional

SEC transaction code indicating the type of transaction (e.g., 'P' for purchase, 'S' for sale, 'A' for grant/award, 'M' for exercise/conversion).

transaction_date

string

optional

Date of the transaction (formatted as YYYY-MM-DD).

transaction_price_per_share

number

optional

Price per share of the transaction in USD.

transaction_shares

number

optional

Number of shares involved in the transaction.

transaction_timeliness

string

optional

Timeliness of the filing: 'O' (on time) or 'L' (late).

transaction_value

number

optional

Total value of the transaction in USD (transaction_shares x transaction_price_per_share). Null when shares or price is not reported.

underlying_security_shares

number

optional

Number of underlying shares for derivative transactions.

underlying_security_title

string

optional

Title of the underlying security for derivative transactions.

status

enum (OK)

The status of this request's response.

Code Examples

curl -X GET "https://api.massive.com/stocks/filings/vX/form-4?limit=100&sort=filing_date.desc&apiKey=YOUR_API_KEY"

from massive import RESTClient

client = RESTClient("YOUR_API_KEY")

filings = []
for f in client.list_stocks_filings_form_4(
    limit="100",
    sort="filing_date.desc"
):
    filings.append(f)

print(filings)

package main

import (
	"context"
	"fmt"
	"log"
	"github.com/massive-com/client-go/v3/rest"
	"github.com/massive-com/client-go/v3/rest/gen"
)

func main() {

	c := rest.NewWithOptions("YOUR_API_KEY",
		rest.WithTrace(false),
		rest.WithPagination(true),
	)
	ctx := context.Background()

	params := &gen.GetStocksFilingsVXForm4Params{
		Limit: rest.Ptr(100),
		Sort: rest.Ptr("filing_date.desc"),
	}

	resp, err := c.GetStocksFilingsVXForm4WithResponse(
		ctx,
		params,
	)
	if err != nil {
		log.Fatal(err)
	}

	if err := rest.CheckResponse(resp); err != nil {
		log.Fatal(err)
	}
	
	iter := rest.NewIteratorFromResponse(c, resp)
	for iter.Next() {
		item := iter.Item()
		fmt.Printf("%+v\n", item)
	}
	if err := iter.Err(); err != nil {
		log.Fatal(err)
	}
}

import { restClient } from '@massive.com/client-js';

const apiKey = "YOUR_API_KEY";
const rest = restClient(apiKey, 'https://api.massive.com');

async function example_getStocksFilingsVXForm4() {
  try {
    const response = await rest.getStocksFilingsVXForm4(
      {
        limit: "100",
        sort: "filing_date.desc"
      }
    );
    console.log('Response:', response);
  } catch (e) {
    console.error('An error happened:', e);
  }
}

example_getStocksFilingsVXForm4();

package com.massive.client

import com.massive.client.apis.DefaultApi
import com.massive.client.infrastructure.*
import com.massive.client.models.*

fun main() {
    ApiClient.apiKey["apiKey"] = "YOUR_API_KEY"

    val api = DefaultApi()
    try {
        val result = api.getStocksFilingsVXForm4(
            limit = "100",
            sort = "filing_date.desc"
        )
        println(result)
    } catch (e: Exception) {
        println("Error calling getStocksFilingsVXForm4: ${e.message}")
        e.printStackTrace()
    }
}

Query URL

GET

https://api.massive.com/stocks/filings/vX/form-4?apiKey=YOUR_API_KEY

Run query unavailable

Create account or sign in to Massive

Scroll to see updated query response

Response Object

{
  "next_url": "https://api.massive.com/stocks/filings/vX/form-4?cursor=eyJsaW1pd...",
  "request_id": "047c7035a86042b1925118e5f68d81b0",
  "results": [
    {
      "accession_number": "0002123147-26-000002",
      "aff_10b5_one": false,
      "date_of_original_submission": null,
      "deemed_execution_date": "2026-03-27",
      "direct_or_indirect": "D",
      "equity_swap_involved": false,
      "exercise_date": "2026-03-27",
      "exercise_price": 88.167,
      "expiration_date": "2026-03-27",
      "filing_date": "2026-03-30",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/1469395/0002123147-26-000002.txt",
      "footnotes": [
        {
          "description": "These shares were acquired at a price of 4955 argentine pesos per share. For reporting purposes, the exercise price has been converted to US dollars based on the exchange rate reported by Banco de la Nacion Argentina for the date of the acquisition, which was 1405 argentine pesos per US dollar. Then multiplied by 25, the Par value or rate of common shares to one ADR.",
          "id": "F1"
        }
      ],
      "form_type": "4",
      "is_director": false,
      "is_officer": true,
      "is_other": false,
      "is_ten_percent_owner": false,
      "issuer_cik": "0001469395",
      "issuer_name": "Pampa Energy Inc.",
      "not_subject_to_section_16": false,
      "officer_title": "Chief Financial Officer",
      "owner_cik": "0002123147",
      "owner_name": "Zuberbuhler Adolfo Fernando",
      "period_of_report": "2026-03-27",
      "record_type": "transaction",
      "security_title": "Common Stock, $25 Par Value",
      "security_type": "derivative",
      "shares_owned_following_transaction": 2759,
      "tickers": [
        "PAM"
      ],
      "transaction_acquired_disposed": "A",
      "transaction_code": "A",
      "transaction_date": "2026-03-27",
      "transaction_price_per_share": 88.167,
      "transaction_shares": 12923,
      "transaction_timeliness": "O",
      "transaction_value": 1139382.141,
      "underlying_security_shares": 12923,
      "underlying_security_title": "PAMP"
    }
  ],
  "status": "OK"
}

// Run a query to see a response

from massive import RESTClient client = RESTClient("YOUR_API_KEY") filings = [] for f in client.list_stocks_filings_form_4( limit="100", sort="filing_date.desc" ): filings.append(f) print(filings)

package main import ( "context" "fmt" "log" "github.com/massive-com/client-go/v3/rest" "github.com/massive-com/client-go/v3/rest/gen" ) func main() { c := rest.NewWithOptions("YOUR_API_KEY", rest.WithTrace(false), rest.WithPagination(true), ) ctx := context.Background() params := &gen.GetStocksFilingsVXForm4Params{ Limit: rest.Ptr(100), Sort: rest.Ptr("filing_date.desc"), } resp, err := c.GetStocksFilingsVXForm4WithResponse( ctx, params, ) if err != nil { log.Fatal(err) } if err := rest.CheckResponse(resp); err != nil { log.Fatal(err) } iter := rest.NewIteratorFromResponse(c, resp) for iter.Next() { item := iter.Item() fmt.Printf("%+v\n", item) } if err := iter.Err(); err != nil { log.Fatal(err) } }

import { restClient } from '@massive.com/client-js'; const apiKey = "YOUR_API_KEY"; const rest = restClient(apiKey, 'https://api.massive.com'); async function example_getStocksFilingsVXForm4() { try { const response = await rest.getStocksFilingsVXForm4( { limit: "100", sort: "filing_date.desc" } ); console.log('Response:', response); } catch (e) { console.error('An error happened:', e); } } example_getStocksFilingsVXForm4();

package com.massive.client import com.massive.client.apis.DefaultApi import com.massive.client.infrastructure.* import com.massive.client.models.* fun main() { ApiClient.apiKey["apiKey"] = "YOUR_API_KEY" val api = DefaultApi() try { val result = api.getStocksFilingsVXForm4( limit = "100", sort = "filing_date.desc" ) println(result) } catch (e: Exception) { println("Error calling getStocksFilingsVXForm4: ${e.message}") e.printStackTrace() } }

{ "next_url": "https://api.massive.com/stocks/filings/vX/form-4?cursor=eyJsaW1pd...", "request_id": "047c7035a86042b1925118e5f68d81b0", "results": [ { "accession_number": "0002123147-26-000002", "aff_10b5_one": false, "date_of_original_submission": null, "deemed_execution_date": "2026-03-27", "direct_or_indirect": "D", "equity_swap_involved": false, "exercise_date": "2026-03-27", "exercise_price": 88.167, "expiration_date": "2026-03-27", "filing_date": "2026-03-30", "filing_url": "https://www.sec.gov/Archives/edgar/data/1469395/0002123147-26-000002.txt", "footnotes": [ { "description": "These shares were acquired at a price of 4955 argentine pesos per share. For reporting purposes, the exercise price has been converted to US dollars based on the exchange rate reported by Banco de la Nacion Argentina for the date of the acquisition, which was 1405 argentine pesos per US dollar. Then multiplied by 25, the Par value or rate of common shares to one ADR.", "id": "F1" } ], "form_type": "4", "is_director": false, "is_officer": true, "is_other": false, "is_ten_percent_owner": false, "issuer_cik": "0001469395", "issuer_name": "Pampa Energy Inc.", "not_subject_to_section_16": false, "officer_title": "Chief Financial Officer", "owner_cik": "0002123147", "owner_name": "Zuberbuhler Adolfo Fernando", "period_of_report": "2026-03-27", "record_type": "transaction", "security_title": "Common Stock, $25 Par Value", "security_type": "derivative", "shares_owned_following_transaction": 2759, "tickers": [ "PAM" ], "transaction_acquired_disposed": "A", "transaction_code": "A", "transaction_date": "2026-03-27", "transaction_price_per_share": 88.167, "transaction_shares": 12923, "transaction_timeliness": "O", "transaction_value": 1139382.141, "underlying_security_shares": 12923, "underlying_security_title": "PAMP" } ], "status": "OK" }