---
title: "Find labels for an address"
method: GET
path: "/query"
tags: ["query"]
---

# Find labels for an address

`GET /query`

This endpoint allows you to retrieve labels for a given address.

  You can specify an address or label query and a limit on the number of results returned. The endpoint uses a search index to search for matching labels, based on the query string. It is updated periodically, so it may take a few minutes for new labels to be searchable.

## Query parameters

- `query` string, required
- `limit` integer

## Response `200`

A list of labels that match the given address query.

- object
  - `data` Label[]
    - `address_name` string — The name of the address for the label
    - `address` string — The address for the label
    - `label_type` string — The type of label (e.g. token, exchange, etc.)
    - `label_subtype` string — The subtype of label (e.g. token_contract_address, exchange_name, etc)
    - `label` string — The name of the label

## Other responses

- `400` — The request was malformed.
- `405` — The HTTP method used is not allowed for this endpoint.
- `429` — Too many requests.
- `500` — Internal server error.

---

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