---
title: "Query annotations linked to a list of objects."
method: POST
path: "http://localhost:8000/{project_id}/annotations/query"
tags: ["annotations"]
---

# Query annotations linked to a list of objects.

`POST http://localhost:8000/{project_id}/annotations/query`

Query annotations linked to a list of objects.

These objects can for instance be neurons, annotations or stack groups. From
a database perspective, these objects are class instances.

Returned is an object with the fields "entities" and "annotations". The
former is an object mapping an entity ID to a list of annotations. Each
annotation is represented by an object containing its "id" and "uid", the
user who annotated it. The latter maps annotation IDs to annotation names.
For instance::

{ "entities": { "42": [{id: 1, uid: 12}, {id: 3, uid: 14}] }, "annotations": { 12: "example1", 14: "example2" } }

## Path parameters

- `project_id` string, required

## Response `201`

Created

---

[API](https://skmtc.net/catmaid/apis/catmaid-api.md) · [All operations](https://skmtc.net/catmaid/apis/catmaid-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/catmaid/catmaid-api/revisions/adc1c7c5eefe/schema)