---
title: "Get Instrument"
method: GET
path: "/instruments/{isin}"
tags: ["Instruments"]
---

# Get Instrument

`GET /instruments/{isin}`

Returns details for a specific instrument identified by its ISIN.
<strong>Test ISINs for Trading Halts</strong>
You can use the following static ISINs to test different predetermined scenarios regarding Trading Halts. The test ISINs are not enabled on our side and are only available in the Sandbox environment.
<ul> <li><code>XF0000000046</code> - <strong>Buy-side halt</strong>: Returns an instrument with an active trading halt on buy orders only <li><code>XF0000000053</code> - <strong>Sell-side halt</strong>: Returns an instrument with an active trading halt on sell orders only <li><code>XF0000000061</code> - <strong>Both-sides halt</strong>: Returns an instrument with an active trading halt on both buy and sell orders </ul>
<strong>Note:</strong>
<ul> <li>These test ISINs are only available on this endpoint. They will not appear in the <code>GET /instruments</code> listing endpoint. <li>The Sandbox behavior of <code>POST /accounts/{account_id}/orders</code> takes these predefined Trading Halts into account: it will thus return a 422 Error when attempting to create an order that would be Halted. </ul>

## Path parameters

- `isin` string, required — An ISIN (International Securities Identification Number) according to ISO 6166. This value uniquely identifies the instrument.

## Headers

- `LMG-Data-Privacy-Access-Principal` string, required
- `LMG-Data-Privacy-Access-Justification` string, required

## Response `200`

Successful Response

- InstrumentResponse — An object representing a financial instrument.
  - `isin` string, required — An ISIN (International Securities Identification Number) according to ISO 6166. This value uniquely identifies the instrument of this position.
  - `title` string, required — The title of the instrument.
  - `type` 'etf' | 'fund' | 'stock', required — A category specifying the type of a financial instrument: <ul> <li><code>etf</code> <li><code>fund</code> <li><code>stock</code> </ul> <strong>Note:</strong> This list is not final, expect other values to be added in the future.
  - `fund_profit_model` 'accumulating' | 'distributing' — A category to represent a fund's model for profit use: <ul> <li><code>accumulating</code> <li><code>distributing</code> </ul>
  - `total_expense_ratio_pct` string, number — A number representing the total expense ratio for a fund. The value is pre-scaled, so `"0.07"` represents 0.07%.
  - `regulatory_information` InstrumentRegulatoryInformationResponse, required — An object representing regulatory information regarding the instrument.
    - `kid` string, uri — The KID (Key Investor Document) for the instrument, usually only available for funds.
  - `active_trading_halts` TradingHaltResponse[] — A list of currently active trading halts for this instrument. Trading halts are temporarily applied by lemon.markets, and restrict buy and/or sell operations on the instrument. This field is only present when there are active trading halts. See <code>GET /instruments/{isin}</code> documentation about ISINs that can be used in the Sandbox environment to test Trading Halt scenarios.
    - `valid_from` string, date-time, required — The date and time from which the trading halt has been active.
    - `valid_to` string, date-time — The date and time until which the trading halt is active. If <code>null</code>, the halt doesn't have yet a definite lifting date.
    - `side` 'buy' | 'sell' — A category to represent the side of a customer's order: <ul> <li><code>buy</code>: Buy shares of an instrument and pay with cash. <li><code>sell</code>: Sell shares of an instrument and receive cash. </ul>

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity
- `5XX` — Server Error

---

[API](https://skmtc.net/lemon/apis/lemon-markets-brokerage-api.md) · [All operations](https://skmtc.net/lemon/apis/lemon-markets-brokerage-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lemon/lemon-markets-brokerage-api/versions/3c8cfd3a96c9/schema)