Skip to main content
GET
/
v1
/
companies
/
{company_id}
/
peers
Sector-based peer companies
curl --request GET \
  --url https://api.ivory.finance/v1/companies/{company_id}/peers \
  --header 'X-API-Key: <api-key>'
{
  "company_id": "<string>",
  "peers": [
    {
      "cik": "<string>",
      "similarity_score": 123,
      "shared_sectors": 123,
      "overlapping_sectors": [
        {
          "sector_id": 123,
          "level_1": "<string>",
          "level_2": "<string>",
          "level_3": "<string>",
          "level_4": "<string>",
          "target_score": 123,
          "peer_score": 123
        }
      ],
      "company_name": "<string>",
      "ticker": "<string>",
      "exchange": "<string>",
      "market_cap": 123
    }
  ],
  "cik": "<string>",
  "ticker": "<string>",
  "name": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.ivory.finance/llms.txt

Use this file to discover all available pages before exploring further.

The company_id accepts TICKER:EXCHANGE (e.g. AAPL:NASDAQ), CC:external_id (e.g. GB:00445790), UUID, bare CIK, or bare external ID. See Get Company for the full format reference.

Authorizations

X-API-Key
string
header
required

Path Parameters

company_id
string
required

Query Parameters

limit
integer
default:10

Max peers to return

Required range: 1 <= x <= 50
min_score
integer
default:30

Minimum sector relevance score (0–100)

Required range: 0 <= x <= 100
min_shared
integer
default:2

Minimum number of shared sectors

Required range: 1 <= x <= 20

Response

Successful Response

company_id
string
required
peers
CompanyPeer · object[]
required
cik
string | null
ticker
string | null
name
string | null