---
title: "Get labels for a blockchain address"
method: GET
path: "/v4/kya/labels"
tags: ["v4/kya"]
---

# Get labels for a blockchain address

`GET /v4/kya/labels`

## Request

- Base URL: `https://api.skyinsights.certik.com`
- URL: `https://api.skyinsights.certik.com/v4/kya/labels`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in header `X-API-Secret`
- TypeScript: <https://skmtc.dev/certik/apis/compliance-aml-saas-api/docs/v4/kya/labels/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns all labels associated with the specified blockchain address

## Query parameters

- `chain` string
- `address` string, required

## Response `200`

OK

- object
  - `code` integer
  - `data` object, nullable
    - `address` string
    - `chain` string
    - `entities` EntityEntity[]
      - `country` EntityLocalized
        - `en` string
        - `zh` string
      - `description` EntityLocalized
        - `en` string
        - `zh` string
      - `entity_id` string
      - `entity_name` EntityLocalized
        - `en` string
        - `zh` string
      - `link` string
      - `other_link` string
    - `entity` EntityEntity
      - `country` EntityLocalized
        - `en` string
        - `zh` string
      - `description` EntityLocalized
        - `en` string
        - `zh` string
      - `entity_id` string
      - `entity_name` EntityLocalized
        - `en` string
        - `zh` string
      - `link` string
      - `other_link` string
    - `entity_id` string
    - `entity_ids` string[]
    - `labels` LabelLabels[]
      - `address` string
      - `category` string
      - `chain` string
      - `label` string
      - `source` string
      - `sub_category` string
      - `ts` integer
  - `message` string

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error

---

[API](https://skmtc.dev/certik/apis/compliance-aml-saas-api.md) - [All operations](https://skmtc.dev/certik/apis/compliance-aml-saas-api/llms.txt) - [OpenAPI document](https://skmtc.dev/certik/apis/compliance-aml-saas-api/revisions/965d8457aab3?raw)