---
title: "The list of entities associated with provided tags"
method: GET
path: "/blockchain-metadata/tagged-entities"
tags: ["Blockchain Metadata"]
---

# The list of entities associated with provided tags

`GET /blockchain-metadata/tagged-entities`

## Request

- Base URL: `https://api.coinmetrics.io/v4`
- URL: `https://api.coinmetrics.io/v4/blockchain-metadata/tagged-entities`
- Auth: API key in query parameter `api_key`
- TypeScript: <https://skmtc.dev/coinmetrics/apis/coin-metrics-api-v4/docs/blockchain-metadata/tagged-entities/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of all entities associated with provided tags.

## Query parameters

- `tags` string[]
- `entities` string[]
- `locations` string[]
- `pretty` boolean
- `page_size` integer
- `next_page_token` string

## Response `200`

List of tagged entities. Ordered by tuple `(entity, tag, location, start_time)` if requested by providing `entities` parameter. Ordered by tuple `(tag, location, entity, started_time)` if requested by providing `tags` parameter.

- BlockchainMetadataTaggedEntitiesResponse: Blockchain metadata tagged entities response
  - `data` BlockchainMetadataTaggedEntity[], required
    - `entity` string, required: The entity tagged.
    - `tag` string, required: Name of the tag.
    - `location` string, required: Asset representation where the entity has been tagged.
    - `type` string, required: Type of the tag. Currently, the available tags are of type `ENTITY`.
    - `tagger_type` string, required: The information about the tagged entity was derived from in-house data `COINMETRICS` or collected using 3rd party sources - `THIRDY_PARTY`.
    - `tagger_method` string, required: The information about the tagged entity was based on factual data `DETERMINISTIC` or based on heuristics `NON_DETERMINISTIC`.
    - `start_time` string: The date-time in ISO 8601 format of when the entity was tagged.
    - `end_time` string: The date-time in ISO 8601 format of when the entity had its tag removed, or the entity no longer exists after this time.
    - `start_block_height` string: The block height when the entity was tagged.
    - `end_block_height` string: The block height when the entity had its tag removed, or the entity no longer exists.
    - `start_block_hash` string: The hash of the block when the entity was tagged.
    - `end_block_hash` string: The hash of block the block when the entity had its tag removed, or the entity no longer exists.
  - `next_page_token` string: Token of the next page results for a given request.
  - `next_page_url` string: URL of the next page results for a given request.

## Other responses

- `401`: Requested resource requires authorization.
- `414`: Provided URI is too long. It must not be greater than 10000 symbols.

---

[API](https://skmtc.dev/coinmetrics/apis/coin-metrics-api-v4.md) - [All operations](https://skmtc.dev/coinmetrics/apis/coin-metrics-api-v4/llms.txt) - [OpenAPI document](https://skmtc.dev/coinmetrics/apis/coin-metrics-api-v4/revisions/774268c0a4fe?raw)