---
title: "Get a market"
method: GET
path: "/v1/markets/{market_id}"
tags: ["Markets"]
---

# Get a market

`GET /v1/markets/{market_id}`

## Request

- Base URL: `https://api.navigateai.co`
- URL: `https://api.navigateai.co/v1/markets/{market_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/navigate/apis/navigateai-api/docs/v1/markets/:market_id/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `market_id` string, required

## Response `200`

OK

- MarketResponse
  - `market` MarketExternalSchema, required
    - `id` string, required
    - `name` string, required: Display name for this market. Must be unique within your organization.
    - `slug` string, required: URL-friendly identifier for this market. Must be unique within your organization. Only lowercase letters and underscores are allowed.
    - `reference_key` string, nullable, required: Optional unique identifier for this market in your system. Must be unique within your organization.

---

[API](https://skmtc.dev/navigate/apis/navigateai-api.md) - [All operations](https://skmtc.dev/navigate/apis/navigateai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/navigate/apis/navigateai-api/revisions/354d82f8ecfc?raw)