curl --request GET \
--url https://astreus.ai/api/v1/companies/{id}/ownership \
--header 'X-API-KEY: <api-key>'import requests
url = "https://astreus.ai/api/v1/companies/{id}/ownership"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://astreus.ai/api/v1/companies/{id}/ownership', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://astreus.ai/api/v1/companies/{id}/ownership",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://astreus.ai/api/v1/companies/{id}/ownership"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-KEY", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://astreus.ai/api/v1/companies/{id}/ownership")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://astreus.ai/api/v1/companies/{id}/ownership")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"cik": "0001045810",
"insiders": [
{
"ownerCik": "0001197649",
"name": "HUANG JEN HSUN",
"isDirector": true,
"isOfficer": true,
"isTenPercentOwner": false,
"officerTitle": "President and CEO",
"totalShares": 811521160,
"directShares": 70100666,
"indirectShares": 741420494,
"asOfDate": "2026-09-17",
"lastFilingDate": "2026-09-18",
"accessionNumber": "0001197649-26-000012"
},
{
"ownerCik": "0001197647",
"name": "COXE TENCH",
"isDirector": true,
"isOfficer": false,
"isTenPercentOwner": false,
"officerTitle": null,
"totalShares": 28581218,
"directShares": 57378,
"indirectShares": 28523840,
"asOfDate": "2026-10-07",
"lastFilingDate": "2026-10-09",
"accessionNumber": "0001197647-26-000011"
}
],
"insidersAttribution": null,
"notices": [
{
"accessionNumber": "0001921094-26-001040",
"filingDate": "2026-09-21",
"personName": "Teter Timothy S.",
"relationships": [
"Officer"
],
"matchedOwnerCik": "0001696841",
"unitsToSell": 30460,
"aggregateMarketValue": 6786532,
"approxSaleDate": "2026-09-21",
"planAdoptionDate": "2026-05-22",
"brokerName": "Charles Schwab & Co., Inc."
},
{
"accessionNumber": "0001628280-25-057153",
"filingDate": "2025-12-15",
"personName": "HARVEY C JONES",
"relationships": [
"DIRECTOR"
],
"matchedOwnerCik": null,
"unitsToSell": 250000,
"aggregateMarketValue": 44323451.25,
"approxSaleDate": "2025-12-15",
"planAdoptionDate": null,
"brokerName": "Merrill Lynch"
}
],
"institutions": [
{
"source": "13F",
"pctOutstanding": null,
"sharesSource": null,
"sharesEstimated": false,
"sharesDerivation": null,
"managerCik": "0002012383",
"managerName": "BlackRock, Inc.",
"periodOfReport": "2026-06-30",
"accessionNumber": "0002012383-26-003238",
"shares": 1941918386,
"valueUsd": 388558449933,
"pctOfSharesOut": 8.0421
},
{
"source": "13F",
"pctOutstanding": null,
"sharesSource": null,
"sharesEstimated": false,
"sharesDerivation": null,
"managerCik": "0002100119",
"managerName": "VANGUARD CAPITAL MANAGEMENT LLC",
"periodOfReport": "2026-06-30",
"accessionNumber": "0002100119-26-001527",
"shares": 1540816358,
"valueUsd": 308301945072,
"pctOfSharesOut": 6.381
}
],
"nationality": []
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}Ownership summary
Insider positions (with the licence attribution when they come from an open-data register, e.g. Taiwan), up to 50 Form 144 notices, the top 50 13F institutional holders, and the shareholder nationality split where the source publishes one (empty for US issuers). Transactions: /ownership/transactions.
curl --request GET \
--url https://astreus.ai/api/v1/companies/{id}/ownership \
--header 'X-API-KEY: <api-key>'import requests
url = "https://astreus.ai/api/v1/companies/{id}/ownership"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://astreus.ai/api/v1/companies/{id}/ownership', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://astreus.ai/api/v1/companies/{id}/ownership",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://astreus.ai/api/v1/companies/{id}/ownership"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-KEY", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://astreus.ai/api/v1/companies/{id}/ownership")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://astreus.ai/api/v1/companies/{id}/ownership")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"cik": "0001045810",
"insiders": [
{
"ownerCik": "0001197649",
"name": "HUANG JEN HSUN",
"isDirector": true,
"isOfficer": true,
"isTenPercentOwner": false,
"officerTitle": "President and CEO",
"totalShares": 811521160,
"directShares": 70100666,
"indirectShares": 741420494,
"asOfDate": "2026-09-17",
"lastFilingDate": "2026-09-18",
"accessionNumber": "0001197649-26-000012"
},
{
"ownerCik": "0001197647",
"name": "COXE TENCH",
"isDirector": true,
"isOfficer": false,
"isTenPercentOwner": false,
"officerTitle": null,
"totalShares": 28581218,
"directShares": 57378,
"indirectShares": 28523840,
"asOfDate": "2026-10-07",
"lastFilingDate": "2026-10-09",
"accessionNumber": "0001197647-26-000011"
}
],
"insidersAttribution": null,
"notices": [
{
"accessionNumber": "0001921094-26-001040",
"filingDate": "2026-09-21",
"personName": "Teter Timothy S.",
"relationships": [
"Officer"
],
"matchedOwnerCik": "0001696841",
"unitsToSell": 30460,
"aggregateMarketValue": 6786532,
"approxSaleDate": "2026-09-21",
"planAdoptionDate": "2026-05-22",
"brokerName": "Charles Schwab & Co., Inc."
},
{
"accessionNumber": "0001628280-25-057153",
"filingDate": "2025-12-15",
"personName": "HARVEY C JONES",
"relationships": [
"DIRECTOR"
],
"matchedOwnerCik": null,
"unitsToSell": 250000,
"aggregateMarketValue": 44323451.25,
"approxSaleDate": "2025-12-15",
"planAdoptionDate": null,
"brokerName": "Merrill Lynch"
}
],
"institutions": [
{
"source": "13F",
"pctOutstanding": null,
"sharesSource": null,
"sharesEstimated": false,
"sharesDerivation": null,
"managerCik": "0002012383",
"managerName": "BlackRock, Inc.",
"periodOfReport": "2026-06-30",
"accessionNumber": "0002012383-26-003238",
"shares": 1941918386,
"valueUsd": 388558449933,
"pctOfSharesOut": 8.0421
},
{
"source": "13F",
"pctOutstanding": null,
"sharesSource": null,
"sharesEstimated": false,
"sharesDerivation": null,
"managerCik": "0002100119",
"managerName": "VANGUARD CAPITAL MANAGEMENT LLC",
"periodOfReport": "2026-06-30",
"accessionNumber": "0002100119-26-001527",
"shares": 1540816358,
"valueUsd": 308301945072,
"pctOfSharesOut": 6.381
}
],
"nationality": []
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}Authorizations
Astreus API key (pk_live_...), created on the Developers page in the terminal. Also accepted as Authorization: Bearer pk_live_....
Path Parameters
Ticker symbol (e.g. NVDA), numeric SEC CIK (zero-padding optional), or the platform key of a non-SEC issuer (e.g. XSAU000001 — the cik field of the company payload). A bare ticker always resolves to the SEC registrant.
Response
OK
Inferred from captured responses: every field shown was returned by a real call; a field may be absent or null on other calls.