> For the complete documentation index, see [llms.txt](https://gitbook-docs.coinmetrics.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook-docs.coinmetrics.io/cm-api-spec/meta-data/blockchain-metadata/the-list-of-entities-associated-with-provided-tags.md).
# The list of entities associated with provided tags
Returns a list of all entities associated with provided tags. 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. Ordered by tuple `(owner_name, location, entity, tag, timestamp_start)` if requested by providing `owner_name` parameter.
```json
{"openapi":"3.0.2","info":{"title":"Coin Metrics API v4","version":"4.0.0"},"tags":[{"name":"Blockchain Metadata","description":"Blockchain metadata endpoints\n\n**Endpoints on this page:**\n- `GET /blockchain-metadata/locations` — List of all available locations\n- `GET /blockchain-metadata/owners` — List of all available owners\n- `GET /blockchain-metadata/tagged-entities` — The list of entities associated with provided tags\n- `GET /blockchain-metadata/tags` — List of all available tags"}],"servers":[{"url":"https://api.coinmetrics.io/v4"},{"url":"wss://api.coinmetrics.io/v4"},{"url":"https://community-api.coinmetrics.io/v4"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"description":"Coin Metrics API key can be specified as `?api_key=` query parameter.","in":"query","name":"api_key","type":"apiKey"}},"parameters":{"Tags":{"description":"Comma separated list of tags. Mutually exclusive with `entities` and `owner_names` parameter. Currently a single tag is allowed in a request.","in":"query","name":"tags","required":false,"schema":{"type":"array","items":{"type":"string"}},"explode":false},"Entities":{"description":"Comma separated list of entities. Mutually exclusive with `tags` and `owner_names` parameter.","in":"query","name":"entities","required":false,"schema":{"type":"array","items":{"type":"string"}},"explode":false},"EntityLocations":{"description":"Comma separated list of entity locations (asset representation where the entity has been tagged). Currently a single entity location is allowed per each request.","in":"query","name":"locations","required":false,"schema":{"type":"array","items":{"type":"string"}},"explode":false},"OwnerNames":{"description":"Comma separated list of owner names. Mutually exclusive with `tags` and `entities` parameters. Currently a single owner name is allowed in a request.","in":"query","name":"owner_names","required":false,"schema":{"type":"array","items":{"type":"string"}},"explode":false},"Pretty":{"description":"Human-readable formatting of JSON responses.","in":"query","name":"pretty","schema":{"type":"boolean","default":false}},"PageSize":{"description":"Number of items per single page of results.
The value of this parameter is ignored if the endpoint supports the `format` parameter and its value is set to `json_stream`.","in":"query","name":"page_size","schema":{"default":100,"type":"integer","format":"int32","minimum":1,"maximum":10000}},"NextPageToken":{"description":"Token for receiving the results from the next page of a query.
Should not be used directly. To iterate through pages just use `next_page_url` response field.","in":"query","name":"next_page_token","schema":{"type":"string"}}},"responses":{"BlockchainMetadataTaggedEntities":{"description":"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. Ordered by tuple `(owner_name, location, entity, tag, timestamp_start)` if requested by providing `owner_name` parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlockchainMetadataTaggedEntitiesResponse"}}}},"Unauthorized":{"description":"Requested resource requires authorization.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"UriTooLong":{"description":"Provided URI is too long. It must not be greater than 10000 symbols."}},"schemas":{"BlockchainMetadataTaggedEntitiesResponse":{"description":"Blockchain metadata tagged entities response","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BlockchainMetadataTaggedEntity"}},"next_page_token":{"$ref":"#/components/schemas/NextPageToken"},"next_page_url":{"$ref":"#/components/schemas/NextPageUrl"}},"required":["data"]},"BlockchainMetadataTaggedEntity":{"type":"object","properties":{"entity":{"type":"string","description":"The entity tagged."},"owner_name":{"type":"string","description":"Name of the owner of the entity."},"tag":{"type":"string","description":"Name of the tag."},"location":{"type":"string","description":"Asset representation where the entity has been tagged."},"type":{"type":"string","description":"Type of the tag. Currently, the available tags are of type `ENTITY`."},"tagger_type":{"type":"string","description":"The information about the tagged entity was derived from in-house data `COINMETRICS` or collected using 3rd party sources - `THIRDY_PARTY`."},"tagger_method":{"type":"string","description":"The information about the tagged entity was based on factual data `DETERMINISTIC` or based on heuristics `NON_DETERMINISTIC`."},"start_time":{"type":"string","description":"The date-time in ISO 8601 format of when the entity was tagged."},"end_time":{"type":"string","description":"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":{"type":"string","description":"The block height when the entity was tagged."},"end_block_height":{"type":"string","description":"The block height when the entity had its tag removed, or the entity no longer exists."},"start_block_hash":{"type":"string","description":"The hash of the block when the entity was tagged."},"end_block_hash":{"type":"string","description":"The hash of block the block when the entity had its tag removed, or the entity no longer exists."}},"required":["entity","tag","location","type","tagger_type","tagger_method"]},"NextPageToken":{"description":"Token of the next page results for a given request.","type":"string"},"NextPageUrl":{"description":"URL of the next page results for a given request.","type":"string"},"ErrorResponse":{"properties":{"error":{"$ref":"#/components/schemas/ErrorObject"}},"required":["error"],"type":"object"},"ErrorObject":{"properties":{"type":{"description":"Error type string. Can be used for error identification.","type":"string"},"message":{"description":"Human-friendly error description. Can be amended without prior notification. Do not use for error identification in your code.","type":"string"}},"required":["type","description"],"type":"object"}}},"paths":{"/blockchain-metadata/tagged-entities":{"get":{"summary":"The list of entities associated with provided tags","description":"Returns a list of all entities associated with provided tags. 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. Ordered by tuple `(owner_name, location, entity, tag, timestamp_start)` if requested by providing `owner_name` parameter.","operationId":"getBlockchainMetadataEntities","tags":["Blockchain Metadata"],"parameters":[{"$ref":"#/components/parameters/Tags"},{"$ref":"#/components/parameters/Entities"},{"$ref":"#/components/parameters/EntityLocations"},{"$ref":"#/components/parameters/OwnerNames"},{"$ref":"#/components/parameters/Pretty"},{"$ref":"#/components/parameters/PageSize"},{"$ref":"#/components/parameters/NextPageToken"}],"responses":{"200":{"$ref":"#/components/responses/BlockchainMetadataTaggedEntities"},"401":{"$ref":"#/components/responses/Unauthorized"},"414":{"$ref":"#/components/responses/UriTooLong"}}}}}}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://gitbook-docs.coinmetrics.io/cm-api-spec/meta-data/blockchain-metadata/the-list-of-entities-associated-with-provided-tags.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.