---
title: "Get by Listing"
method: POST
path: "/v1/knowledge-graph/companies/listing"
tags: ["Companies"]
---

# Get by Listing

`POST /v1/knowledge-graph/companies/listing`

Locate companies using exchange listing identifiers.

## Request body

- ListingRequest — Request body for listing lookups
  - `values` string[], required — Array of listing codes. Listing format: Combination of Market Identifier Code (MIC) and company ticker separated by ":"

## Response `200`

Successful response with company data mapped by listing

- MarketIdResponse — Response containing company data mapped by market identifiers
  - `results` object, required — Object containing market identifiers as keys and company data as values
  - `metadata` object, required
    - `request_id` string, required — Unique request identifier
    - `timestamp` string, date-time, required — Response timestamp
  - `usage` Usage
    - `knowledge_graph_tokens` integer, required — Number of tokens consumed by this request.

---

[API](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api.md) · [All operations](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bigdata/bigdata-structured-data-api/revisions/18082de268c4/schema)