GET
/v2/insidersRetrieve SEC Forms 3, 4, and 5 (insider trading) filings. Returns full parsed documents with transaction details including derivative and non-derivative holdings and transactions.
Required Parameters
| Name | Type | Description |
|---|---|---|
api_keyrequired | string | Your API key for authentication |
Filter Parameters
| Name | Type | Description |
|---|---|---|
ciks | string[] | Filter by company CIK numbers (issuer CIK) Example: ["320193", "789019"] |
tickers | string[] | Filter by stock ticker symbols (resolved to CIKs) Example: ["AAPL", "MSFT"] |
form_types | string[] | Filter by form type. Valid values: "3", "4", "5". Default: all three. Example: ["4"] |
date_from | string | Start date for filing date filter (YYYY-MM-DD) Example: "2024-01-01" |
date_to | string | End date for filing date filter (YYYY-MM-DD) Example: "2024-12-31" |
Pagination
| Name | Type | Description |
|---|---|---|
from | number | Start index for pagination. Default: 0 |
to | number | End index for pagination. Default: 1000 |
Form Types
Form 3 - Initial Statement of Beneficial Ownership
Filed within 10 days of becoming an officer, director, or 10% shareholder. Reports initial holdings at the time of becoming an insider.
Form 4 - Statement of Changes in Beneficial Ownership
Filed within 2 business days of any transaction. Reports purchases, sales, option exercises, and other changes in insider holdings.
Form 5 - Annual Statement of Beneficial Ownership
Filed annually within 45 days of fiscal year end. Reports transactions not previously reported on Form 4 and certain exempt transactions.
Examples
Get Form 4 Filings by Ticker
cURL
curl -X POST "https://api.secblast.com/v2/insiders" \
-H "Content-Type: application/json" \
-d '{
"api_key": "YOUR_KEY",
"tickers": ["AAPL"],
"form_types": ["4"],
"from": 0,
"to": 10
}'Get All Insider Filings by CIK with Date Range
cURL
curl -X POST "https://api.secblast.com/v2/insiders" \
-H "Content-Type: application/json" \
-d '{
"api_key": "YOUR_KEY",
"ciks": ["320193"],
"date_from": "2024-01-01",
"date_to": "2024-12-31"
}'Get Initial Ownership Statements (Form 3)
cURL
curl "https://api.secblast.com/v2/insiders?api_key=YOUR_KEY&tickers=MSFT&form_types=[%223%22]"Response
200Success
{
"count": 1,
"truncated": false,
"filings": [
{
"accession_number": "0001127602-24-012345",
"form_type": "4",
"filing_date": "2024-06-15",
"issuer_cik": "320193",
"filer_cik": "1234567",
"data": {
"schemaVersion": "X0508",
"documentType": "4",
"periodOfReport": "2024-06-13",
"issuer": {
"issuerCik": "320193",
"issuerName": "Apple Inc.",
"issuerTradingSymbol": "AAPL"
},
"reportingOwner": {
"reportingOwnerId": {
"rptOwnerCik": "1234567",
"rptOwnerName": "WILLIAMS JEFFREY E"
},
"reportingOwnerAddress": {
"rptOwnerStreet1": "ONE APPLE PARK WAY",
"rptOwnerCity": "CUPERTINO",
"rptOwnerState": "CA",
"rptOwnerZipCode": "95014"
},
"reportingOwnerRelationship": {
"isDirector": true,
"isOfficer": true,
"officerTitle": "Chief Operating Officer"
}
},
"nonDerivativeTable": {
"nonDerivativeTransaction": [
{
"securityTitle": "Common Stock",
"transactionDate": "2024-06-13",
"transactionCoding": {
"transactionFormType": "4",
"transactionCode": "S",
"equitySwapInvolved": false
},
"transactionAmounts": {
"transactionShares": 50000,
"transactionPricePerShare": 195.50,
"transactionAcquiredDisposedCode": "D"
},
"postTransactionAmounts": {
"sharesOwnedFollowingTransaction": 450000
},
"ownershipNature": {
"directOrIndirectOwnership": "D"
}
}
]
},
"derivativeTable": {
"derivativeHolding": [
{
"securityTitle": "Restricted Stock Units",
"underlyingSecurity": {
"underlyingSecurityTitle": "Common Stock",
"underlyingSecurityShares": 125000
}
}
]
}
}
}
]
}400Error - Missing required parameter
{
"error": "Must provide at least one cik or ticker"
}Transaction Codes
| Code | Description |
|---|---|
| P | Open market or private purchase |
| S | Open market or private sale |
| A | Grant, award, or other acquisition |
| D | Disposition to the issuer |
| F | Payment of exercise price or tax liability |
| M | Exercise or conversion of derivative security |
| G | Gift |
| J | Other acquisition or disposition |