---
title: "List the labels written under a source (operator keys only)"
method: GET
path: "/v1/labels"
tags: ["Write"]
---

# List the labels written under a source (operator keys only)

`GET /v1/labels`

## Request

- Base URL: `https://intelapi.publicaml.org`
- URL: `https://intelapi.publicaml.org/v1/labels`
- Auth: API key in header `X-Signature` and API key in header `X-API-Key` and API key in header `X-Timestamp`

Your own pushes only, newest checked first. This is an admin boundary, not a privacy boundary: the underlying labels are globally visible once they join the graph.

## Query parameters

- `source` string, required
- `written_by` string
- `chain` 'bitcoin' | 'ethereum' | 'bsc' | 'tron' | 'solana': Which blockchain the address belongs to. Send one of the values in the enum. The short forms used by the older clients (ETH, BTC, TRX, BNB) and any capitalisation are still accepted, but responses always echo the canonical spelling. Getting this wrong is the single commonest integration bug: the same 0x-prefixed address exists on ethereum, bsc and tron and means a different wallet on each, so the chain is part of the identity, never a hint. If it does not match the address format the call fails with `invalid_address_format`, which names the chain the address does look like. `solana` (short form `SOL`) is accepted here as well as by the enrich endpoints: a Solana label is stored and served by /v2/enrich from attribution alone (no graph, no score). Solana addresses are case-sensitive and are stored exactly as sent; a malformed one is refused per entry with `invalid_address_format`.
- `category` string
- `limit` integer
- `offset` integer

## Response `200`

Your labels.

- object

## Other responses

- `400`: Malformed request.
- `429`: Rate limited: anonymous callers, and keys issued with a quota of their own. Authenticate to remove the limit.
- `500`: Server error.

---

[API](https://skmtc.dev/publicaml/apis/publicaml-intelligence-api.md) · [All operations](https://skmtc.dev/publicaml/apis/publicaml-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/publicaml/apis/publicaml-intelligence-api/revisions/7c0c6315088c?raw)