---
title: "Broker Registry"
method: GET
path: "/v2/brokers/"
tags: ["Brokers"]
---

# Broker Registry

`GET /v2/brokers/`

Curated registry of IDX exchange-member brokers with name, origin (foreign / domestic), cohort (retail / mixed / institutional / unknown), and license type. Use this as the authoritative source for valid broker codes when calling broker-scoped endpoints such as `/v2/broker-activity/{broker_code}/`.

<Info>Costs 1 API credit.</Info>

## Query parameters

- `cohort` 'institutional' | 'mixed' | 'retail' | 'unknown'
- `origin` 'domestic' | 'foreign'

## Response `200`

List of brokers with code, name, foreign flag, cohort, and license type.

- BrokerRegistryRow[]
  - `code` string, required — Broker code.
  - `name` string, required — Human-readable broker name.
  - `is_foreign` boolean, required
  - `cohort` string, nullable, required — One of: retail, mixed, institutional, unknown; null if unclassified.
  - `license_type` string, nullable, required

## Other responses

- `429` — Rate limit exceeded.

---

[API](https://skmtc.dev/sectors/apis/sectors-api.md) · [All operations](https://skmtc.dev/sectors/apis/sectors-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sectors/sectors-api/revisions/49e492f19d77/schema)