---
title: "Find listings by company name or ticker (query), by ISIN (isin), or list every listing of one market (exchange or market), across US and other exchanges. A US listing is its bare ticker and a listing on another exchange is MIC:TICKER, the spelling every price and company route accepts. An ISIN returns every listing of that security, each in its own currency; a US or Canadian ISIN also matches a US listing by its CUSIP. Search results rank exact tickers, then names, then larger companies; a market listing is in exchange then ticker order."
method: GET
path: "/v1/listings"
tags: ["Listings"]
---

# Find listings by company name or ticker (query), by ISIN (isin), or list every listing of one market (exchange or market), across US and other exchanges. A US listing is its bare ticker and a listing on another exchange is MIC:TICKER, the spelling every price and company route accepts. An ISIN returns every listing of that security, each in its own currency; a US or Canadian ISIN also matches a US listing by its CUSIP. Search results rank exact tickers, then names, then larger companies; a market listing is in exchange then ticker order.

`GET /v1/listings`

## Request

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

## Query parameters

- `query` string
- `isin` string
- `exchange` string
- `market` string
- `limit` integer
- `offset` integer

## Response `200`

OK

- ListingDtoPagedResponse
  - `listingNotice` ListingNotice: What happened to a requested ticker that no longer trades. "delisted": the company has no current US listing, so the answer is its history. "renamed": the company now trades as successorTicker, its current US presentation ticker (possibly another share class). A listed series (short volume, short interest, off-exchange volume, fails-to-deliver, congressional trades) is the retired ticker's own; a company-level read is the company's data.
    - `status` string, nullable: "delisted" or "renamed".
    - `ticker` string, nullable: The retired ticker as listed.
    - `delistedOn` string, date, nullable: The day the retired listing stopped trading, when known.
    - `successorTicker` string, nullable: For "renamed", the company's current US presentation ticker; null for "delisted".
  - `data` ListingDto[], nullable
    - `ticker` string, nullable: A bare ticker for a US listing (BRK-B), or MIC:TICKER for a listing on another exchange (XETR:SIE).
    - `exchange` string, nullable: The ISO 10383 market identifier code of a listing outside the US; absent for a US listing.
    - `market` string, nullable: ISO country code of the listing's market.
    - `currency` string, nullable: ISO 4217 code the listing trades in.
    - `isin` string, nullable: The security's ISIN, when on record.
    - `cusip` string, nullable: The security's CUSIP, for a US listing when on record.
    - `companyName` string, nullable: The company that issued the security.
    - `securityType` string, nullable: OrdinaryShare, PreferredShare, DepositaryReceipt, TrustUnit, ExchangeTradedFund, ExchangeTradedNote (an exchange-traded commodity or note), Other or Unknown, from the security's authoritative registration.
    - `primary` boolean: True for the company's main listing.
    - `exchangeTradedProduct` boolean: True for an exchange-traded product: a US ETF or ETN in the market-data reference directory, or an exchange-traded fund, commodity or note listed on another exchange.
  - `meta` PageMeta
    - `limit` integer
    - `offset` integer
    - `count` integer
    - `hasMore` boolean
    - `total` integer, nullable

## Other responses

- `400`: Bad Request

---

[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)