---
title: "A company's customers, suppliers, competitors and partners named in annual 10-K reports: its own and those of other listed companies that name it, each with the verbatim sentence, the source filing, any revenue or receivables share the filing states and, for a revenue share, its dollar amount from the same filing's revenue. Competitors carry who names the rivalry. A missing company is not evidence of no relationship. Requires the Pro plan; other plans get the counts and the unnamed overview."
method: GET
path: "/v1/stocks/{ticker}/supply-chain"
tags: ["SupplyChain"]
---

# A company's customers, suppliers, competitors and partners named in annual 10-K reports: its own and those of other listed companies that name it, each with the verbatim sentence, the source filing, any revenue or receivables share the filing states and, for a revenue share, its dollar amount from the same filing's revenue. Competitors carry who names the rivalry. A missing company is not evidence of no relationship. Requires the Pro plan; other plans get the counts and the unnamed overview.

`GET /v1/stocks/{ticker}/supply-chain`

## Request

- Base URL: `https://api.equibles.com`
- URL: `https://api.equibles.com/v1/stocks/{ticker}/supply-chain`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/equibles/apis/equibles-api/docs/v1/stocks/:ticker/supply-chain/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `ticker` string, required

## Query parameters

- `side` string
- `quantifiedOnly` boolean
- `lens` string
- `limit` integer

## Response `200`

OK

- SupplyChainResponse: A company's supply chain from annual 10-K reports: its own and those of other listed companies that name it. Without the Pro plan, every list is empty and only the counts and the unnamed overview are returned.
  - `ticker` string, nullable: The company's resolved symbol: a US ticker, or MIC:TICKER for a listing outside the US.
  - `companyName` string, nullable
  - `annualReport` SupplyChainFilingDto: The annual report a supply chain was read from.
    - `form` string, nullable
    - `filedDate` string, date
    - `filingUrl` string, nullable: The filing on sec.gov.
  - `namedOnlyByOthers` boolean: True for a company listed only outside the US: every row comes from a US company's 10-K.
  - `locked` boolean: True when the caller's plan does not include supply chains: no company is named.
  - `upgradeUrl` string, nullable: Where to upgrade when locked, otherwise null.
  - `counts` SupplyChainCountsDto: Companies per side of a supply chain.
    - `customers` integer
    - `suppliers` integer
    - `competitors` integer
    - `partners` integer
  - `overview` SupplyChainOverviewDto: Headline shares, each stated by a filing. Without the Pro plan the companies are not named.
    - `namedCustomerShare` number, double, nullable: The summed revenue share the company's own 10-K states for its named customers, in percent.
    - `namedCustomerShareIsFloor` boolean: True when a "10% or more" share makes namedCustomerShare a floor.
    - `namedCustomerCount` integer
    - `namedCustomerPeriod` string, nullable: The period the filing states for those shares, as written.
    - `largestCustomer` SupplyChainTopShareDto: One headline share. Name and ticker are null without the Pro plan.
      - `name` string, nullable
      - `ticker` string, nullable
      - `percent` number, double: Percent of the stating filer's revenue.
      - `isFloor` boolean
      - `period` string, nullable: The period as the filing writes it.
    - `mostReliantSupplier` SupplyChainTopShareDto: One headline share. Name and ticker are null without the Pro plan.
      - `name` string, nullable
      - `ticker` string, nullable
      - `percent` number, double: Percent of the stating filer's revenue.
      - `isFloor` boolean
      - `period` string, nullable: The period as the filing writes it.
  - `customers` SupplyChainCompanyDto[], nullable
    - `name` string, nullable: The name as the filing writes it.
    - `ticker` string, nullable: Its listed symbol (MIC:TICKER outside the US), or null when it matched no listed company.
    - `organization` SupplyChainOrganizationDto: An organization no market we cover lists, with its page.
      - `slug` string, nullable: The organization's slug, for /v1/organizations/{slug}.
      - `url` string, nullable: Its page on equibles.com.
    - `partOf` string, nullable: The company on the same side it is part of, listed above it ("U.S. Government" for the DoW). Its share is inside the parent's, so the two are never added. Absent at the top level.
    - `depth` integer, nullable: How many levels under a top-level company it sits (1 directly under its parent). Absent at the top level.
    - `competitorNamedBy` string, nullable: Competitors only: whose 10-K names the rivalry. "both", "company" (only this company's 10-K names the competitor) or "competitor" (only the competitor's 10-K names this company). Null on the other sides.
    - `statements` SupplyChainStatementDto[], nullable
      - `statedBy` string, nullable: The ticker (or name) of the company whose filing states it.
      - `isOwnFiling` boolean: True when the statement comes from this company's own 10-K, false when another filer's 10-K names it.
      - `form` string, nullable
      - `filedDate` string, date
      - `filingUrl` string, nullable: The filing on sec.gov.
      - `quote` string, nullable: The verbatim sentence.
      - `role` string, nullable: What the counterparty does, as the filing describes it, or null.
      - `via` string, nullable: The part of the company the filer named when it named a part rather than the whole ("Google" on Alphabet). Its share is a lower bound of the whole company's. Absent when the filer named the company itself.
      - `share` SupplyChainShareDto: A share of the stating filer's own revenue or receivables, as the filing states it.
        - `percent` number, double, nullable: The stated percent, or null when the filing gives only a floor.
        - `percentFloor` number, double, nullable: The floor of a "10% or more" statement, or null.
        - `basis` string, nullable: "Revenue" or "Receivables".
        - `period` string, nullable: The period as the filing writes it.
      - `value` SupplyChainShareValueDto: A stated revenue share in US dollars: the share times the annual revenue the same filing reports.
        - `amountUsd` number, double
        - `isFloor` boolean: True when the share is a floor, so the amount is a floor too.
        - `revenueUsd` number, double: The stating filer's annual revenue the amount is computed from.
        - `revenuePeriodEnd` string, date
        - `customerRevenueShare` number, double, nullable: Derived: the amount as a percent of the customer's own revenue for an overlapping fiscal year, or null.
        - `customerRevenueUsd` number, double, nullable
        - `customerRevenuePeriodEnd` string, date, nullable
  - `suppliers` SupplyChainCompanyDto[], nullable
    - `name` string, nullable: The name as the filing writes it.
    - `ticker` string, nullable: Its listed symbol (MIC:TICKER outside the US), or null when it matched no listed company.
    - `organization` SupplyChainOrganizationDto: An organization no market we cover lists, with its page.
      - `slug` string, nullable: The organization's slug, for /v1/organizations/{slug}.
      - `url` string, nullable: Its page on equibles.com.
    - `partOf` string, nullable: The company on the same side it is part of, listed above it ("U.S. Government" for the DoW). Its share is inside the parent's, so the two are never added. Absent at the top level.
    - `depth` integer, nullable: How many levels under a top-level company it sits (1 directly under its parent). Absent at the top level.
    - `competitorNamedBy` string, nullable: Competitors only: whose 10-K names the rivalry. "both", "company" (only this company's 10-K names the competitor) or "competitor" (only the competitor's 10-K names this company). Null on the other sides.
    - `statements` SupplyChainStatementDto[], nullable
      - `statedBy` string, nullable: The ticker (or name) of the company whose filing states it.
      - `isOwnFiling` boolean: True when the statement comes from this company's own 10-K, false when another filer's 10-K names it.
      - `form` string, nullable
      - `filedDate` string, date
      - `filingUrl` string, nullable: The filing on sec.gov.
      - `quote` string, nullable: The verbatim sentence.
      - `role` string, nullable: What the counterparty does, as the filing describes it, or null.
      - `via` string, nullable: The part of the company the filer named when it named a part rather than the whole ("Google" on Alphabet). Its share is a lower bound of the whole company's. Absent when the filer named the company itself.
      - `share` SupplyChainShareDto: A share of the stating filer's own revenue or receivables, as the filing states it.
        - `percent` number, double, nullable: The stated percent, or null when the filing gives only a floor.
        - `percentFloor` number, double, nullable: The floor of a "10% or more" statement, or null.
        - `basis` string, nullable: "Revenue" or "Receivables".
        - `period` string, nullable: The period as the filing writes it.
      - `value` SupplyChainShareValueDto: A stated revenue share in US dollars: the share times the annual revenue the same filing reports.
        - `amountUsd` number, double
        - `isFloor` boolean: True when the share is a floor, so the amount is a floor too.
        - `revenueUsd` number, double: The stating filer's annual revenue the amount is computed from.
        - `revenuePeriodEnd` string, date
        - `customerRevenueShare` number, double, nullable: Derived: the amount as a percent of the customer's own revenue for an overlapping fiscal year, or null.
        - `customerRevenueUsd` number, double, nullable
        - `customerRevenuePeriodEnd` string, date, nullable
  - `competitors` SupplyChainCompanyDto[], nullable
    - `name` string, nullable: The name as the filing writes it.
    - `ticker` string, nullable: Its listed symbol (MIC:TICKER outside the US), or null when it matched no listed company.
    - `organization` SupplyChainOrganizationDto: An organization no market we cover lists, with its page.
      - `slug` string, nullable: The organization's slug, for /v1/organizations/{slug}.
      - `url` string, nullable: Its page on equibles.com.
    - `partOf` string, nullable: The company on the same side it is part of, listed above it ("U.S. Government" for the DoW). Its share is inside the parent's, so the two are never added. Absent at the top level.
    - `depth` integer, nullable: How many levels under a top-level company it sits (1 directly under its parent). Absent at the top level.
    - `competitorNamedBy` string, nullable: Competitors only: whose 10-K names the rivalry. "both", "company" (only this company's 10-K names the competitor) or "competitor" (only the competitor's 10-K names this company). Null on the other sides.
    - `statements` SupplyChainStatementDto[], nullable
      - `statedBy` string, nullable: The ticker (or name) of the company whose filing states it.
      - `isOwnFiling` boolean: True when the statement comes from this company's own 10-K, false when another filer's 10-K names it.
      - `form` string, nullable
      - `filedDate` string, date
      - `filingUrl` string, nullable: The filing on sec.gov.
      - `quote` string, nullable: The verbatim sentence.
      - `role` string, nullable: What the counterparty does, as the filing describes it, or null.
      - `via` string, nullable: The part of the company the filer named when it named a part rather than the whole ("Google" on Alphabet). Its share is a lower bound of the whole company's. Absent when the filer named the company itself.
      - `share` SupplyChainShareDto: A share of the stating filer's own revenue or receivables, as the filing states it.
        - `percent` number, double, nullable: The stated percent, or null when the filing gives only a floor.
        - `percentFloor` number, double, nullable: The floor of a "10% or more" statement, or null.
        - `basis` string, nullable: "Revenue" or "Receivables".
        - `period` string, nullable: The period as the filing writes it.
      - `value` SupplyChainShareValueDto: A stated revenue share in US dollars: the share times the annual revenue the same filing reports.
        - `amountUsd` number, double
        - `isFloor` boolean: True when the share is a floor, so the amount is a floor too.
        - `revenueUsd` number, double: The stating filer's annual revenue the amount is computed from.
        - `revenuePeriodEnd` string, date
        - `customerRevenueShare` number, double, nullable: Derived: the amount as a percent of the customer's own revenue for an overlapping fiscal year, or null.
        - `customerRevenueUsd` number, double, nullable
        - `customerRevenuePeriodEnd` string, date, nullable
  - `partners` SupplyChainCompanyDto[], nullable
    - `name` string, nullable: The name as the filing writes it.
    - `ticker` string, nullable: Its listed symbol (MIC:TICKER outside the US), or null when it matched no listed company.
    - `organization` SupplyChainOrganizationDto: An organization no market we cover lists, with its page.
      - `slug` string, nullable: The organization's slug, for /v1/organizations/{slug}.
      - `url` string, nullable: Its page on equibles.com.
    - `partOf` string, nullable: The company on the same side it is part of, listed above it ("U.S. Government" for the DoW). Its share is inside the parent's, so the two are never added. Absent at the top level.
    - `depth` integer, nullable: How many levels under a top-level company it sits (1 directly under its parent). Absent at the top level.
    - `competitorNamedBy` string, nullable: Competitors only: whose 10-K names the rivalry. "both", "company" (only this company's 10-K names the competitor) or "competitor" (only the competitor's 10-K names this company). Null on the other sides.
    - `statements` SupplyChainStatementDto[], nullable
      - `statedBy` string, nullable: The ticker (or name) of the company whose filing states it.
      - `isOwnFiling` boolean: True when the statement comes from this company's own 10-K, false when another filer's 10-K names it.
      - `form` string, nullable
      - `filedDate` string, date
      - `filingUrl` string, nullable: The filing on sec.gov.
      - `quote` string, nullable: The verbatim sentence.
      - `role` string, nullable: What the counterparty does, as the filing describes it, or null.
      - `via` string, nullable: The part of the company the filer named when it named a part rather than the whole ("Google" on Alphabet). Its share is a lower bound of the whole company's. Absent when the filer named the company itself.
      - `share` SupplyChainShareDto: A share of the stating filer's own revenue or receivables, as the filing states it.
        - `percent` number, double, nullable: The stated percent, or null when the filing gives only a floor.
        - `percentFloor` number, double, nullable: The floor of a "10% or more" statement, or null.
        - `basis` string, nullable: "Revenue" or "Receivables".
        - `period` string, nullable: The period as the filing writes it.
      - `value` SupplyChainShareValueDto: A stated revenue share in US dollars: the share times the annual revenue the same filing reports.
        - `amountUsd` number, double
        - `isFloor` boolean: True when the share is a floor, so the amount is a floor too.
        - `revenueUsd` number, double: The stating filer's annual revenue the amount is computed from.
        - `revenuePeriodEnd` string, date
        - `customerRevenueShare` number, double, nullable: Derived: the amount as a percent of the customer's own revenue for an overlapping fiscal year, or null.
        - `customerRevenueUsd` number, double, nullable
        - `customerRevenuePeriodEnd` string, date, nullable

## Other responses

- `400`: Bad Request
- `404`: Not Found

---

[API](https://skmtc.dev/equibles/apis/equibles-api.md) - [All operations](https://skmtc.dev/equibles/apis/equibles-api/llms.txt) - [OpenAPI document](https://skmtc.dev/equibles/apis/equibles-api/revisions/666e06778588?raw)