> ## Documentation Index > Fetch the complete documentation index at: https://doc.astreus.ai/llms.txt > Use this file to discover all available pages before exploring further. # 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). The edge must belong to the company in the path. ## OpenAPI ````yaml /openapi.json get /api/v1/companies/{id}/supply-chain/{edgeKey} openapi: 3.1.0 info: title: Astreus API version: 1.0.0 description: >- Astreus is a financial data terminal that turns the world's unstructured financial disclosure into structured, traceable data. It reads what companies, exchanges and central banks publish — annual and interim reports, SEC filings, results announcements, investor presentations, earnings calls, 8-Ks, regulator notices and policy text — across the United States, the Gulf (Tadawul, DFM, ADX, Boursa Kuwait, QSE), Japan, Taiwan, Korea, the UK and Europe, and serves it as data a program can trust: standardized financial statements (annual, quarterly, semiannual), segments and KPIs, the tables inside the notes, filing sections as text, investor decks page by page, earnings-call transcripts and audio, span-anchored observations, management guidance scored against outcomes, typed 8-K events, an attributed intraday news tape, insider and 13F ownership, a people registry, point-in-time macro series and central-bank text, benchmark, commodity and compute-price series, and a validated causal claim graph with scenario simulation. Every number carries the filing, page or passage it came from (`fact-source`), and nothing is served until it passes per-company validation gates. Coverage is published live: `GET /api/v1/landing/coverage` (no key) returns every market served with company counts, history depth, completeness and periods held per data type — ask it before answering "what do you cover?". `{id}` is a ticker, a numeric SEC CIK, or a platform key for a non-SEC issuer (XSAU000001) — the `cik` field of the company payload. Human-readable guides: https://doc.astreus.ai (coverage at /coverage, data catalog at /data-catalog). Tiers: `public` endpoints need no credentials. Everything else takes an **API key** — create one on the Developers page in the terminal (https://astreus.ai/developers) and send it as `X-API-KEY: pk_live_...` (or `Authorization: Bearer pk_live_...`). Signed-in terminal sessions may use their Cognito ID token instead. Rate limits and quotas are per plan (fixed UTC windows): Free — 30 req/min, 250 req/day; Build — 300 req/min, 100,000 req/month; Scale — custom. Build, Scale and prepaid credits are set up with sales (https://astreus.ai/contact), not self-serve. Responses carry RateLimit-*, X-Quota-* and, when credits pay, X-Billing-Source/X-Credits-Remaining-USD headers; a 429 carries `Retry-After` and a machine `code` of rate_limited or quota_exceeded (with sales_email). Not investment advice. See /terms. contact: email: saif@astreus.ai termsOfService: https://astreus.ai/terms servers: - url: https://astreus.ai security: [] tags: - name: Search & Meta description: Entity resolution and platform metadata. - name: Company Data description: Profiles, structure, leadership, calendars. - name: Financial Statements description: >- Standardized XBRL-derived statements — every line traceable to its filing via fact provenance. - name: SEC Filings description: >- The filing index and documents (SEC and exchange-published), parsed section text, and the tables inside the notes as gated grids and series. - name: 8-K Events description: Material events, typed by family, with extracted item text. - name: News description: >- The intraday news tape: filings, releases and licensed wires with source attribution, storylines and topics. - name: Transcripts & Calls description: Earnings-call transcripts, span-anchored observations, IR decks. - name: Guidance & Scorecards description: What management promised vs. what happened. - name: Ownership & Insiders description: 13F holders, Forms 3/4/5, the people registry. - name: Macro description: Point-in-time economic series and central-bank text. - name: Market Data description: Daily bars for stocks, benchmarks, commodities and compute. - name: Intelligence description: Narratives, the validated claim graph, scenario simulation. - name: Analytics description: Correlation and charting over any catalog series. paths: /api/v1/companies/{id}/supply-chain/{edgeKey}: get: tags: - Company Data summary: Supply-chain relationship description: >- 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). The edge must belong to the company in the path. operationId: get-supply-chain-relationship parameters: - name: id in: path required: true description: >- 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. schema: type: string - name: edgeKey in: path required: true schema: type: string description: edge_key from the supply-chain list. - name: as_of in: query description: 'YYYY-MM-DD: public information through the end of that UTC date.' schema: type: string responses: '200': description: OK content: application/json: schema: type: object additionalProperties: true example: supply_chain_edge: company: cik: '0001045810' name: NVIDIA CORP ticker: NVDA relationship: edge_key: 2178ffc83e8605da2ac5ac20448111ee7a419e71 kind: supply role_for_subject: supplier scope: direct_commercial other_party: counterparty_id: 1182 kind: public_company name: Fabrinet cik: '0001408710' ticker: FN direction: disclosed_by_other assertion_count: 15 latest_period_end: '2026-06-26' freshness: latest_public_at: '2026-08-18T11:12:07.000Z' stale: false superseded: false metrics: - metric: attributed_revenue_amount whose: cik: '0001408710' name: Fabrinet period_start: '2025-06-28' period_end: '2026-06-26' periodicity: annual value: '756498811' unit: USD approximate: true state: eligible reasons: [] notes: - derived_from_rounded_pct provenance: discloser_cik: '0001408710' accession: 0001408710-26-000028 public_at: '2026-08-18T11:12:07.000Z' evidence_id: 426 quant_id: 7191 fact_source_key: >- rel::2178ffc83e8605da2ac5ac20448111ee7a419e71::attributed_revenue_amount::7191 low: '754178262.5' high: '758819359.5' currency: USD - metric: discloser_revenue_pct whose: cik: '0001408710' name: Fabrinet period_start: '2025-06-28' period_end: '2026-06-26' periodicity: annual value: '16.3' unit: pct approximate: true state: eligible reasons: [] notes: [] provenance: discloser_cik: '0001408710' accession: 0001408710-26-000028 public_at: '2026-08-18T11:12:07.000Z' evidence_id: 426 quant_id: 7190 fact_source_key: >- rel::2178ffc83e8605da2ac5ac20448111ee7a419e71::discloser_revenue_pct::7190 low: '16.25' high: '16.35' - metric: receivables_pct whose: cik: '0001408710' name: Fabrinet period_start: '2024-06-29' period_end: '2025-06-27' periodicity: annual value: '25.5' unit: pct approximate: true state: eligible reasons: [] notes: [] provenance: discloser_cik: '0001408710' accession: 0001408710-26-000028 public_at: '2026-08-18T11:12:07.000Z' evidence_id: 424 quant_id: 7187 fact_source_key: >- rel::2178ffc83e8605da2ac5ac20448111ee7a419e71::receivables_pct::7187 low: '25.45' high: '25.55' as_of: null history: - metric: attributed_revenue_amount whose: cik: '0001408710' name: Fabrinet period_start: '2025-06-28' period_end: '2026-06-26' periodicity: annual value: '756498811' unit: USD approximate: true state: eligible reasons: [] notes: - derived_from_rounded_pct provenance: discloser_cik: '0001408710' accession: 0001408710-26-000028 public_at: '2026-08-18T11:12:07.000Z' evidence_id: 426 quant_id: 7191 fact_source_key: >- rel::2178ffc83e8605da2ac5ac20448111ee7a419e71::attributed_revenue_amount::7191 low: '754178262.5' high: '758819359.5' currency: USD - metric: discloser_revenue_pct whose: cik: '0001408710' name: Fabrinet period_start: '2025-06-28' period_end: '2026-06-26' periodicity: annual value: '16.3' unit: pct approximate: true state: eligible reasons: [] notes: [] provenance: discloser_cik: '0001408710' accession: 0001408710-26-000028 public_at: '2026-08-18T11:12:07.000Z' evidence_id: 426 quant_id: 7190 fact_source_key: >- rel::2178ffc83e8605da2ac5ac20448111ee7a419e71::discloser_revenue_pct::7190 low: '16.25' high: '16.35' - metric: attributed_revenue_amount whose: cik: '0001408710' name: Fabrinet period_start: '2024-06-29' period_end: '2025-06-27' periodicity: annual value: '943734252' unit: USD approximate: true state: eligible reasons: [] notes: - derived_from_rounded_pct provenance: discloser_cik: '0001408710' accession: 0001408710-26-000028 public_at: '2026-08-18T11:12:07.000Z' evidence_id: 421 quant_id: 7184 fact_source_key: >- rel::2178ffc83e8605da2ac5ac20448111ee7a419e71::attributed_revenue_amount::7184 low: '942024588.5' high: '945443915.5' currency: USD - metric: attributed_revenue_amount whose: cik: '0001408710' name: Fabrinet period_start: '2024-06-29' period_end: '2025-06-27' periodicity: annual value: '943734252' unit: USD approximate: true state: eligible reasons: [] notes: - derived_from_rounded_pct provenance: discloser_cik: '0001408710' accession: 0001408710-25-000039 public_at: '2025-08-19T11:13:26.000Z' evidence_id: 413 quant_id: 7171 fact_source_key: >- rel::2178ffc83e8605da2ac5ac20448111ee7a419e71::attributed_revenue_amount::7171 low: '942024588.5' high: '945443915.5' currency: USD evidence: - evidence_id: 426 discloser_cik: '0001408710' accession: 0001408710-26-000028 source_kind: xbrl_pct subject_role: supplier other_party_raw: fn:NvidiaCorporationMember other_party_kind: named scope: direct_commercial benchmark: us-gaap:SalesRevenueNetMember benchmark_family: revenue pct: '16.3' pct_precision_pp: '0.05' amount: null currency: null bound: null period_start: '2025-06-28' period_end: '2026-06-26' periodicity: annual scope_dimensions: [] public_at: '2026-08-18T11:12:07.000Z' public_precision: instant locator: concept: us-gaap:ConcentrationRiskPercentage1 context_id: c-400 context_hash: >- f7ac1eb2d2764b30ec9fa396c61f807eaaa6027030781f785494ebfe7d02633d source_fact_id: 56733197 - evidence_id: 424 discloser_cik: '0001408710' accession: 0001408710-26-000028 source_kind: xbrl_pct subject_role: supplier other_party_raw: fn:NvidiaCorporationMember other_party_kind: named scope: direct_commercial benchmark: us-gaap:AccountsReceivableMember benchmark_family: receivables pct: '25.5' pct_precision_pp: '0.05' amount: null currency: null bound: null period_start: '2024-06-29' period_end: '2025-06-27' periodicity: annual scope_dimensions: [] public_at: '2026-08-18T11:12:07.000Z' public_precision: instant locator: concept: us-gaap:ConcentrationRiskPercentage1 context_id: c-410 context_hash: >- 799c5ce67c99e047d34350f52392ebdbceb2315254c01bb309e56cb0cc5bec40 source_fact_id: 56733207 '400': description: Invalid parameter. content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Missing or invalid bearer token. content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: Unknown company, country, symbol or resource. content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Rate limited. Honour Retry-After. content: application/json: schema: $ref: '#/components/schemas/Error' security: - apiKey: [] - cognitoIdToken: [] components: schemas: Error: type: object required: - error properties: error: type: string description: Human-readable message. code: type: string description: >- Stable machine code when present: unauthenticated, upgrade_required, rate_limited, quota_exceeded. enum: - unauthenticated - upgrade_required - rate_limited - quota_exceeded securitySchemes: apiKey: type: apiKey in: header name: X-API-KEY description: >- Astreus API key (pk_live_...), created on the Developers page in the terminal. Also accepted as `Authorization: Bearer pk_live_...`. x-default: pk_live_YOUR_KEY cognitoIdToken: type: http scheme: bearer bearerFormat: JWT description: >- Amazon Cognito ID token (token_use=id) for the Astreus user pool — the terminal's own session credential. API consumers should use an API key instead. ````