---
title: "Search equities in the Sugra Catalog"
method: GET
path: "/api/v1/catalog/equities"
tags: ["Catalog"]
---

# Search equities in the Sugra Catalog

`GET /api/v1/catalog/equities`

Search the catalog of listed companies. All filters are optional and combined with AND. Each result carries the company's listings (ticker, exchange, MIC, currency, identifiers). By default only companies with at least one active listing are returned; set `include_delisted=true` to include companies whose listings are all delisted.

## Query parameters

- `sector` string, nullable — Sector classification to filter by (exact match).
- `industry` string, nullable — Industry to filter by (exact match).
- `country` string, nullable — Country of the company to filter by (exact match).
- `exchange` string, nullable — Restrict to companies with a listing on this exchange.
- `market_cap` string, nullable — Market-capitalization bucket to filter by (exact match).
- `q` string, nullable — Free-text search over the company name.
- `include_delisted` boolean — Include companies whose only listings are delisted.
- `limit` integer — Maximum number of companies to return.
- `offset` integer — Number of companies to skip (pagination).

## Response `200`

Matching companies with their listings, plus the total match count for pagination.

- unknown

## Other responses

- `401` — Missing or invalid `x-api-key` header. JSON body with a stable `code` distinguishing `missing_api_key` (no header sent) from `invalid_api_key` (header sent, key not accepted); any other 401 source carries the generic `unauthorized` with its detail as `reason`. Plus `hint`. `plan` is always null on 401 - an unauthenticated request has no plan; quota exhaustion is 429, not 401.
- `422` — Validation Error
- `429` — Daily rate limit exceeded. Check `X-RateLimit-Reset` for the next window.
- `503` — Upstream source is temporarily unavailable. Retry after a short delay.

---

[API](https://skmtc.net/sugra/apis/sugra-api.md) · [All operations](https://skmtc.net/sugra/apis/sugra-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sugra/sugra-api/versions/4c4530760ba1/schema)