---
title: "On-demand Hong Kong Companies Registry open-data search"
method: GET
path: "/api/v1/companies-registry/search"
---

# On-demand Hong Kong Companies Registry open-data search

`GET /api/v1/companies-registry/search`

## Request

- Base URL: `https://www.trusgent.com`
- URL: `https://www.trusgent.com/api/v1/companies-registry/search`
- Auth: one of:
  - none
  - HTTP bearer

Live lookup via data.cr.gov.hk (BRN equal or company-name begins_with). Not a bulk company dump; rate-limited. Cite Companies Registry / data.gov.hk as the source.

## Query parameters

- `q` string, required
- `limit` integer

## Response `200`

Companies Registry open-data hits

## Other responses

- `400`: Invalid query
- `429`: Rate limited
- `502`: Upstream Companies Registry error

---

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