---
title: "Get instrument venues"
method: GET
path: "/instruments/{instrument_id}/venues"
tags: ["Price Data"]
---

# Get instrument venues

`GET /instruments/{instrument_id}/venues`

## Request

- Base URL: `https://sandbox.upvest.co`
- URL: `https://sandbox.upvest.co/instruments/{instrument_id}/venues`
- Auth: OAuth 2 (client credentials, token URL `https://sandbox.upvest.co/auth/token`, scopes: `prices:read`)

The venues where the instrument is traded and for which the price data is available.

## Response `200`

OK

- object: The trading venues at which price data is available for an instrument.
  - `data` object[], required: The trading venues available for the instrument.
    - `name` string: The name of the trading venue.
    - `id` string, uuid, required: The unique identifier of the trading venue, as a UUID.
    - `price_qualities` string[]: The available price qualities.

## Other responses

- `401`: Unauthorized. The caller has not been authenticated.
- `403`: Forbidden. The caller has been authenticated but is not allowed to take the requested action.
- `404`: Not Found. The requested resource could not be found.
- `406`: Not Acceptable. The resource does not have a current representation that would be acceptable to the user agent. "Accept" header defined unsupported value.
- `429`: Too Many Requests. The caller has exceeded their quota for the time period and has been throttled.
- `500`: Internal Server Error. The service encountered an unexpected error.
- `503`: Service Unavailable. The service handling for this request cannot be reached at this time.
- `504`: Gateway Timeout. The service gateway has reached its internal timeout.

---

[API](https://skmtc.dev/upvest/apis/upvest-investment-api.md) · [All operations](https://skmtc.dev/upvest/apis/upvest-investment-api/llms.txt) · [OpenAPI document](https://skmtc.dev/upvest/apis/upvest-investment-api/revisions/ca69534b631d?raw)
