curl --request GET \
--url https://astreus.ai/api/v1/companies/{id}/observations \
--header 'X-API-KEY: <api-key>'import requests
url = "https://astreus.ai/api/v1/companies/{id}/observations"
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}/observations', 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}/observations",
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}/observations"
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}/observations")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://astreus.ai/api/v1/companies/{id}/observations")
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"
],
"observations": [
{
"id": 162316,
"eventFamily": "mna",
"eventType": "acquisition_agreement",
"subject": "Hugging Face, Inc.",
"action": "acquire",
"eventDate": "2026-09-02",
"eventDateKind": "agreement",
"filingDate": "2026-09-03",
"summary": "NVIDIA Corporation entered into a definitive agreement to acquire Hugging Face, Inc.",
"headline": "NVIDIA agrees to acquire Hugging Face for $11.9B",
"supportingQuote": "On September 2, 2026, NVIDIA Corporation (“NVIDIA”) entered into a definitive agreement to acquire Hugging Face, Inc. (“Hugging Face”).",
"metadata": {
"deal_value": {
"parsed": {
"amount": 11900000000,
"currency": "USD"
},
"fact_index": 1,
"value_text": "$11.9 billion"
},
"counterparty": {
"parsed": null,
"fact_index": 0,
"value_text": "Hugging Face, Inc."
},
"expected_close_text": {
"parsed": null,
"fact_index": 2,
"value_text": "first half of 2027"
}
},
"facts": [
{
"label": "counterparty",
"quote_end": 207,
"value_text": "Hugging Face, Inc.",
"quote_start": 72,
"supporting_quote": "On September 2, 2026, NVIDIA Corporation (“NVIDIA”) entered into a definitive agreement to acquire Hugging Face, Inc. (“Hugging Face”)."
},
{
"label": "deal_value",
"quote_end": 481,
"value_text": "$11.9 billion",
"quote_start": 341,
"supporting_quote": "The transaction includes an approximately $11.9 billion purchase price payable to Hugging Face stockholders, subject to certain adjustments,"
}
],
"accessionNumber": "0001045810-26-000078",
"itemCode": "8.01",
"itemName": "Other Events",
"trust": "verified"
},
{
"id": 129496,
"eventFamily": "earnings",
"eventType": "earnings_release",
"subject": null,
"action": "announced_earnings",
"eventDate": "2026-08-26",
"eventDateKind": "announcement",
"filingDate": "2026-08-26",
"summary": "Earnings release announced",
"headline": "NVIDIA reports results for quarter ended July 26, 2026",
"supportingQuote": "On August 26, 2026, NVIDIA Corporation, or the Company, issued a press release announcing its results for the quarter ended July 26, 2026. The press release is attached as Exhibit 99.1 and is incorpor…",
"metadata": null,
"facts": null,
"accessionNumber": "0001045810-26-000073",
"itemCode": "2.02",
"itemName": "Results of Operations and Financial Condition",
"trust": "verified"
}
],
"total": 249,
"offset": 0,
"nextOffset": 2,
"limit": 2,
"hasMore": true
}{
"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>"
]
}Observations
Span-verified 8-K event observations, newest event first (event date, else filing date). Calls are not a source. Paged: limit (1–500, default 50, for every caller) and offset; the body carries total, limit, offset, hasMore and nextOffset. Rows are read from the newest 500, so from/to and offset page only within those 500.
curl --request GET \
--url https://astreus.ai/api/v1/companies/{id}/observations \
--header 'X-API-KEY: <api-key>'import requests
url = "https://astreus.ai/api/v1/companies/{id}/observations"
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}/observations', 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}/observations",
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}/observations"
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}/observations")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://astreus.ai/api/v1/companies/{id}/observations")
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"
],
"observations": [
{
"id": 162316,
"eventFamily": "mna",
"eventType": "acquisition_agreement",
"subject": "Hugging Face, Inc.",
"action": "acquire",
"eventDate": "2026-09-02",
"eventDateKind": "agreement",
"filingDate": "2026-09-03",
"summary": "NVIDIA Corporation entered into a definitive agreement to acquire Hugging Face, Inc.",
"headline": "NVIDIA agrees to acquire Hugging Face for $11.9B",
"supportingQuote": "On September 2, 2026, NVIDIA Corporation (“NVIDIA”) entered into a definitive agreement to acquire Hugging Face, Inc. (“Hugging Face”).",
"metadata": {
"deal_value": {
"parsed": {
"amount": 11900000000,
"currency": "USD"
},
"fact_index": 1,
"value_text": "$11.9 billion"
},
"counterparty": {
"parsed": null,
"fact_index": 0,
"value_text": "Hugging Face, Inc."
},
"expected_close_text": {
"parsed": null,
"fact_index": 2,
"value_text": "first half of 2027"
}
},
"facts": [
{
"label": "counterparty",
"quote_end": 207,
"value_text": "Hugging Face, Inc.",
"quote_start": 72,
"supporting_quote": "On September 2, 2026, NVIDIA Corporation (“NVIDIA”) entered into a definitive agreement to acquire Hugging Face, Inc. (“Hugging Face”)."
},
{
"label": "deal_value",
"quote_end": 481,
"value_text": "$11.9 billion",
"quote_start": 341,
"supporting_quote": "The transaction includes an approximately $11.9 billion purchase price payable to Hugging Face stockholders, subject to certain adjustments,"
}
],
"accessionNumber": "0001045810-26-000078",
"itemCode": "8.01",
"itemName": "Other Events",
"trust": "verified"
},
{
"id": 129496,
"eventFamily": "earnings",
"eventType": "earnings_release",
"subject": null,
"action": "announced_earnings",
"eventDate": "2026-08-26",
"eventDateKind": "announcement",
"filingDate": "2026-08-26",
"summary": "Earnings release announced",
"headline": "NVIDIA reports results for quarter ended July 26, 2026",
"supportingQuote": "On August 26, 2026, NVIDIA Corporation, or the Company, issued a press release announcing its results for the quarter ended July 26, 2026. The press release is attached as Exhibit 99.1 and is incorpor…",
"metadata": null,
"facts": null,
"accessionNumber": "0001045810-26-000073",
"itemCode": "2.02",
"itemName": "Results of Operations and Financial Condition",
"trust": "verified"
}
],
"total": 249,
"offset": 0,
"nextOffset": 2,
"limit": 2,
"hasMore": true
}{
"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.
Query Parameters
Event family (same list as /events/wire); an unknown one is a 400.
Include rows still under review (1).
First filing date, YYYY-MM-DD.
Last filing date, YYYY-MM-DD.
Rows per page, 1–500, default 50.
1 <= x <= 500Rows to skip (the previous nextOffset), default 0.
x >= 0