Supply-chain relationship
curl --request GET \
--url https://astreus.ai/api/v1/companies/{id}/supply-chain/{edgeKey} \
--header 'X-API-KEY: <api-key>'import requests
url = "https://astreus.ai/api/v1/companies/{id}/supply-chain/{edgeKey}"
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}/supply-chain/{edgeKey}', 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}/supply-chain/{edgeKey}",
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}/supply-chain/{edgeKey}"
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}/supply-chain/{edgeKey}")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://astreus.ai/api/v1/companies/{id}/supply-chain/{edgeKey}")
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{
"supply_chain_edge": {
"company": {
"cik": "0001045810",
"name": "NVIDIA CORP",
"ticker": "NVDA"
},
"relationship": {
"edge_key": "3629338af105d0275fbc821e173ce0f1551214c9",
"kind": "supply",
"role_for_subject": "customer",
"scope": "direct_commercial",
"other_party": {
"counterparty_id": 11727,
"kind": "anonymous",
"name": "Customer One",
"cik": null,
"ticker": null,
"country": null,
"sector": null,
"anonymous_scope": {
"accession": "0001045810-26-000021",
"member": "nvda:CustomerOneMember"
}
},
"direction": "disclosed_by_subject",
"evidence_basis": "filed_structured",
"assertion_basis": {
"filed_structured": 5,
"company_published": 0,
"human_certified": 0,
"model_extracted": 0,
"call_transcript": 0
},
"assertion_count": 5,
"latest_period_end": "2026-01-25",
"freshness": {
"latest_public_at": "2026-02-25T21:42:19.000Z",
"stale": false,
"superseded": false
},
"metrics": [
{
"metric": "discloser_revenue_pct",
"whose": {
"cik": "0001045810",
"name": "NVIDIA CORP"
},
"period_start": "2025-01-27",
"period_end": "2026-01-25",
"periodicity": "annual",
"value": "22",
"unit": "pct",
"approximate": true,
"scope_dimensions": [
[
"us-gaap:StatementBusinessSegmentsAxis",
"nvda:ComputeAndNetworkingSegmentMember"
]
],
"state": "eligible",
"reasons": [],
"notes": [],
"provenance": {
"discloser_cik": "0001045810",
"accession": "0001045810-26-000021",
"public_at": "2026-02-25T21:42:19.000Z",
"evidence_id": 32272,
"quant_id": 51185,
"fact_source_key": "rel::3629338af105d0275fbc821e173ce0f1551214c9::discloser_revenue_pct::51185"
},
"low": "21.5",
"high": "22.5"
},
{
"metric": "receivables_pct",
"whose": {
"cik": "0001045810",
"name": "NVIDIA CORP"
},
"period_start": "2025-01-27",
"period_end": "2026-01-25",
"periodicity": "annual",
"value": "25",
"unit": "pct",
"approximate": true,
"scope_dimensions": [],
"state": "eligible",
"reasons": [],
"notes": [],
"provenance": {
"discloser_cik": "0001045810",
"accession": "0001045810-26-000021",
"public_at": "2026-02-25T21:42:19.000Z",
"evidence_id": 32268,
"quant_id": 51180,
"fact_source_key": "rel::3629338af105d0275fbc821e173ce0f1551214c9::receivables_pct::51180"
},
"low": "24.5",
"high": "25.5"
}
]
},
"as_of": null,
"history": [
{
"metric": "attributed_revenue_amount",
"whose": {
"cik": "0001045810",
"name": "NVIDIA CORP"
},
"period_start": "2025-01-27",
"period_end": "2026-01-25",
"periodicity": "annual",
"value": null,
"unit": "pct",
"approximate": true,
"scope_dimensions": [
[
"us-gaap:StatementBusinessSegmentsAxis",
"nvda:ComputeAndNetworkingSegmentMember"
]
],
"state": "withheld",
"reasons": [
"benchmark_scope_attached"
],
"notes": [],
"provenance": {
"discloser_cik": "0001045810",
"accession": "0001045810-26-000021",
"public_at": "2026-02-25T21:42:19.000Z",
"evidence_id": 32272,
"quant_id": 51186,
"fact_source_key": "rel::3629338af105d0275fbc821e173ce0f1551214c9::attributed_revenue_amount::51186"
}
},
{
"metric": "discloser_revenue_pct",
"whose": {
"cik": "0001045810",
"name": "NVIDIA CORP"
},
"period_start": "2025-01-27",
"period_end": "2026-01-25",
"periodicity": "annual",
"value": "22",
"unit": "pct",
"approximate": true,
"scope_dimensions": [
[
"us-gaap:StatementBusinessSegmentsAxis",
"nvda:ComputeAndNetworkingSegmentMember"
]
],
"state": "eligible",
"reasons": [],
"notes": [],
"provenance": {
"discloser_cik": "0001045810",
"accession": "0001045810-26-000021",
"public_at": "2026-02-25T21:42:19.000Z",
"evidence_id": 32272,
"quant_id": 51185,
"fact_source_key": "rel::3629338af105d0275fbc821e173ce0f1551214c9::discloser_revenue_pct::51185"
},
"low": "21.5",
"high": "22.5"
}
],
"evidence": [
{
"evidence_id": 32272,
"discloser_cik": "0001045810",
"accession": "0001045810-26-000021",
"source_kind": "xbrl_pct",
"serving_basis": "filed_structured",
"quote": null,
"subtype": null,
"subject_role": "supplier",
"other_party_raw": "nvda:CustomerOneMember",
"other_party_kind": "anonymous",
"scope": "direct_commercial",
"benchmark": "us-gaap:SalesRevenueNetMember",
"benchmark_family": "revenue",
"pct": "22",
"pct_precision_pp": "0.5",
"amount": null,
"currency": null,
"bound": null,
"period_start": "2025-01-27",
"period_end": "2026-01-25",
"periodicity": "annual",
"scope_dimensions": [
[
"us-gaap:StatementBusinessSegmentsAxis",
"nvda:ComputeAndNetworkingSegmentMember"
]
],
"public_at": "2026-02-25T21:42:19.000Z",
"public_precision": "instant",
"locator": {
"concept": "us-gaap:ConcentrationRiskPercentage1",
"context_id": "c-227",
"context_hash": "ad3dfcf569aa5106473f18678c4838fbd4374ec4e65a12b233b35176b87e0ee1",
"source_fact_id": 2166195
}
},
{
"evidence_id": 32268,
"discloser_cik": "0001045810",
"accession": "0001045810-26-000021",
"source_kind": "xbrl_pct",
"serving_basis": "filed_structured",
"quote": null,
"subtype": null,
"subject_role": "supplier",
"other_party_raw": "nvda:CustomerOneMember",
"other_party_kind": "anonymous",
"scope": "direct_commercial",
"benchmark": "us-gaap:AccountsReceivableMember",
"benchmark_family": "receivables",
"pct": "25",
"pct_precision_pp": "0.5",
"amount": null,
"currency": null,
"bound": null,
"period_start": "2025-01-27",
"period_end": "2026-01-25",
"periodicity": "annual",
"scope_dimensions": [],
"public_at": "2026-02-25T21:42:19.000Z",
"public_precision": "instant",
"locator": {
"concept": "us-gaap:ConcentrationRiskPercentage1",
"context_id": "c-126",
"context_hash": "a924c8170195da990c24acdc9b9847b64fb44b60268f7261fbb0199ecab34f20",
"source_fact_id": 2165810
}
}
]
}
}{
"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>"
]
}Company Data
Supply-chain relationship
One relationship in full: current metrics, every served measurement period (eligible and withheld with reasons) and the evidence rows behind it (discloser, accession, XBRL context, quote locator). An analyst-curated competitor (evidence_basis analyst_curated) returns its curation with empty history and evidence. The edge must belong to the company in the path.
GET
/
api
/
v1
/
companies
/
{id}
/
supply-chain
/
{edgeKey}
Supply-chain relationship
curl --request GET \
--url https://astreus.ai/api/v1/companies/{id}/supply-chain/{edgeKey} \
--header 'X-API-KEY: <api-key>'import requests
url = "https://astreus.ai/api/v1/companies/{id}/supply-chain/{edgeKey}"
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}/supply-chain/{edgeKey}', 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}/supply-chain/{edgeKey}",
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}/supply-chain/{edgeKey}"
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}/supply-chain/{edgeKey}")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://astreus.ai/api/v1/companies/{id}/supply-chain/{edgeKey}")
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{
"supply_chain_edge": {
"company": {
"cik": "0001045810",
"name": "NVIDIA CORP",
"ticker": "NVDA"
},
"relationship": {
"edge_key": "3629338af105d0275fbc821e173ce0f1551214c9",
"kind": "supply",
"role_for_subject": "customer",
"scope": "direct_commercial",
"other_party": {
"counterparty_id": 11727,
"kind": "anonymous",
"name": "Customer One",
"cik": null,
"ticker": null,
"country": null,
"sector": null,
"anonymous_scope": {
"accession": "0001045810-26-000021",
"member": "nvda:CustomerOneMember"
}
},
"direction": "disclosed_by_subject",
"evidence_basis": "filed_structured",
"assertion_basis": {
"filed_structured": 5,
"company_published": 0,
"human_certified": 0,
"model_extracted": 0,
"call_transcript": 0
},
"assertion_count": 5,
"latest_period_end": "2026-01-25",
"freshness": {
"latest_public_at": "2026-02-25T21:42:19.000Z",
"stale": false,
"superseded": false
},
"metrics": [
{
"metric": "discloser_revenue_pct",
"whose": {
"cik": "0001045810",
"name": "NVIDIA CORP"
},
"period_start": "2025-01-27",
"period_end": "2026-01-25",
"periodicity": "annual",
"value": "22",
"unit": "pct",
"approximate": true,
"scope_dimensions": [
[
"us-gaap:StatementBusinessSegmentsAxis",
"nvda:ComputeAndNetworkingSegmentMember"
]
],
"state": "eligible",
"reasons": [],
"notes": [],
"provenance": {
"discloser_cik": "0001045810",
"accession": "0001045810-26-000021",
"public_at": "2026-02-25T21:42:19.000Z",
"evidence_id": 32272,
"quant_id": 51185,
"fact_source_key": "rel::3629338af105d0275fbc821e173ce0f1551214c9::discloser_revenue_pct::51185"
},
"low": "21.5",
"high": "22.5"
},
{
"metric": "receivables_pct",
"whose": {
"cik": "0001045810",
"name": "NVIDIA CORP"
},
"period_start": "2025-01-27",
"period_end": "2026-01-25",
"periodicity": "annual",
"value": "25",
"unit": "pct",
"approximate": true,
"scope_dimensions": [],
"state": "eligible",
"reasons": [],
"notes": [],
"provenance": {
"discloser_cik": "0001045810",
"accession": "0001045810-26-000021",
"public_at": "2026-02-25T21:42:19.000Z",
"evidence_id": 32268,
"quant_id": 51180,
"fact_source_key": "rel::3629338af105d0275fbc821e173ce0f1551214c9::receivables_pct::51180"
},
"low": "24.5",
"high": "25.5"
}
]
},
"as_of": null,
"history": [
{
"metric": "attributed_revenue_amount",
"whose": {
"cik": "0001045810",
"name": "NVIDIA CORP"
},
"period_start": "2025-01-27",
"period_end": "2026-01-25",
"periodicity": "annual",
"value": null,
"unit": "pct",
"approximate": true,
"scope_dimensions": [
[
"us-gaap:StatementBusinessSegmentsAxis",
"nvda:ComputeAndNetworkingSegmentMember"
]
],
"state": "withheld",
"reasons": [
"benchmark_scope_attached"
],
"notes": [],
"provenance": {
"discloser_cik": "0001045810",
"accession": "0001045810-26-000021",
"public_at": "2026-02-25T21:42:19.000Z",
"evidence_id": 32272,
"quant_id": 51186,
"fact_source_key": "rel::3629338af105d0275fbc821e173ce0f1551214c9::attributed_revenue_amount::51186"
}
},
{
"metric": "discloser_revenue_pct",
"whose": {
"cik": "0001045810",
"name": "NVIDIA CORP"
},
"period_start": "2025-01-27",
"period_end": "2026-01-25",
"periodicity": "annual",
"value": "22",
"unit": "pct",
"approximate": true,
"scope_dimensions": [
[
"us-gaap:StatementBusinessSegmentsAxis",
"nvda:ComputeAndNetworkingSegmentMember"
]
],
"state": "eligible",
"reasons": [],
"notes": [],
"provenance": {
"discloser_cik": "0001045810",
"accession": "0001045810-26-000021",
"public_at": "2026-02-25T21:42:19.000Z",
"evidence_id": 32272,
"quant_id": 51185,
"fact_source_key": "rel::3629338af105d0275fbc821e173ce0f1551214c9::discloser_revenue_pct::51185"
},
"low": "21.5",
"high": "22.5"
}
],
"evidence": [
{
"evidence_id": 32272,
"discloser_cik": "0001045810",
"accession": "0001045810-26-000021",
"source_kind": "xbrl_pct",
"serving_basis": "filed_structured",
"quote": null,
"subtype": null,
"subject_role": "supplier",
"other_party_raw": "nvda:CustomerOneMember",
"other_party_kind": "anonymous",
"scope": "direct_commercial",
"benchmark": "us-gaap:SalesRevenueNetMember",
"benchmark_family": "revenue",
"pct": "22",
"pct_precision_pp": "0.5",
"amount": null,
"currency": null,
"bound": null,
"period_start": "2025-01-27",
"period_end": "2026-01-25",
"periodicity": "annual",
"scope_dimensions": [
[
"us-gaap:StatementBusinessSegmentsAxis",
"nvda:ComputeAndNetworkingSegmentMember"
]
],
"public_at": "2026-02-25T21:42:19.000Z",
"public_precision": "instant",
"locator": {
"concept": "us-gaap:ConcentrationRiskPercentage1",
"context_id": "c-227",
"context_hash": "ad3dfcf569aa5106473f18678c4838fbd4374ec4e65a12b233b35176b87e0ee1",
"source_fact_id": 2166195
}
},
{
"evidence_id": 32268,
"discloser_cik": "0001045810",
"accession": "0001045810-26-000021",
"source_kind": "xbrl_pct",
"serving_basis": "filed_structured",
"quote": null,
"subtype": null,
"subject_role": "supplier",
"other_party_raw": "nvda:CustomerOneMember",
"other_party_kind": "anonymous",
"scope": "direct_commercial",
"benchmark": "us-gaap:AccountsReceivableMember",
"benchmark_family": "receivables",
"pct": "25",
"pct_precision_pp": "0.5",
"amount": null,
"currency": null,
"bound": null,
"period_start": "2025-01-27",
"period_end": "2026-01-25",
"periodicity": "annual",
"scope_dimensions": [],
"public_at": "2026-02-25T21:42:19.000Z",
"public_precision": "instant",
"locator": {
"concept": "us-gaap:ConcentrationRiskPercentage1",
"context_id": "c-126",
"context_hash": "a924c8170195da990c24acdc9b9847b64fb44b60268f7261fbb0199ecab34f20",
"source_fact_id": 2165810
}
}
]
}
}{
"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
apiKeycognitoIdToken
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.
edge_key from the supply-chain list.
Query Parameters
YYYY-MM-DD: public information through the end of that UTC date.
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.
Show child attributes
Show child attributes