--- title: "List annotations" method: GET path: "/api/v1/annotations" tags: ["Annotation"] --- # List annotations `GET /api/v1/annotations` Retrieve all annotation objects. ## Query parameters - `page_size` integer - `cursor` string - `id` integer[] - `status` string - `modifier` string - `confirmed_by` string - `deleted_by` string - `exported_by` string - `purged_by` string - `rejected_by` string - `assignees` string - `labels` string - `document` integer - `queue` integer[] - `queue__workspace` string - `relations__parent` integer - `relations__type` string - `relations__key` string - `arrived_at_before` string, date-time - `arrived_at_after` string, date-time - `assigned_at_before` string, date-time - `assigned_at_after` string, date-time - `confirmed_at_before` string, date-time - `confirmed_at_after` string, date-time - `modified_at_before` string, date-time - `modified_at_after` string, date-time - `deleted_at_before` string, date-time - `deleted_at_after` string, date-time - `exported_at_before` string, date-time - `exported_at_after` string, date-time - `export_failed_at_before` string, date-time - `export_failed_at_after` string, date-time - `purged_at_before` string, date-time - `purged_at_after` string, date-time - `rejected_at_before` string, date-time - `rejected_at_after` string, date-time - `restricted_access` boolean - `automated` boolean - `has_email_thread_with_replies` boolean - `has_email_thread_with_new_replies` boolean - `search` string - `ordering` 'document' | '-document' | 'document__arrived_at' | '-document__arrived_at' | 'document__original_file_name' | '-document__original_file_name' | 'modifier' | '-modifier' | 'modifier__username' | '-modifier__username' | 'modified_by' | '-modified_by' | 'modified_by__username' | '-modified_by__username' | 'creator' | '-creator' | 'creator__username' | '-creator__username' | 'queue' | '-queue' | 'status' | '-status' | 'created_at' | '-created_at' | 'assigned_at' | '-assigned_at' | 'confirmed_at' | '-confirmed_at' | 'modified_at' | '-modified_at' | 'exported_at' | '-exported_at' | 'export_failed_at' | '-export_failed_at' | 'purged_at' | '-purged_at' | 'rejected_at' | '-rejected_at' | 'deleted_at' | '-deleted_at' | 'confirmed_by' | '-confirmed_by' | 'deleted_by' | '-deleted_by' | 'exported_by' | '-exported_by' | 'purged_by' | '-purged_by' | 'rejected_by' | '-rejected_by' | 'confirmed_by__username' | '-confirmed_by__username' | 'deleted_by__username' | '-deleted_by__username' | 'exported_by__username' | '-exported_by__username' | 'purged_by__username' | '-purged_by__username' | 'rejected_by__username' | '-rejected_by__username' - `fields` string - `fields!` string - `sideload` string - `content.schema_id` string ## Response `200` OK - object - `pagination` Pagination, required - `next` string, uri, nullable — URL for the next page of results. Contains an opaque signed `cursor` query parameter. Use this URL directly to fetch the next page — do not attempt to construct or modify the cursor value. - `previous` string, uri, nullable — URL for the previous page of results. Contains an opaque signed `cursor` query parameter. Use this URL directly to fetch the previous page — do not attempt to construct or modify the cursor value. - `results` Annotation[], required - `id` integer, required — ID of the annotation. - `url` string, uri, required — URL of the annotation. - `status` 'confirmed' | 'created' | 'deleted' | 'exported' | 'exporting' | 'failed_export' | 'failed_import' | 'importing' | 'in_workflow' | 'postponed' | 'purged' | 'rejected' | 'reviewing' | 'split' | 'to_review', required — Status of the document, see [Annotation Lifecycle](/guides/annotation-lifecycle) for more details. - `document` string, uri, required — Related [document](/api/document). - `queue` string, uri, required — A [queue](/api/queue) that annotation belongs to. - `schema` string, uri, required — A [schema](/api/schema) that defines content shape. - `relations` string[], required — List of relations that annotation belongs to. - `pages` string[], required — List of rendered [pages](/api/page). - `creator` string, uri, nullable, required — User that created the object. - `created_at` string, date-time, required — Timestamp of object's creation. - `modifier` string, uri, nullable, required — User that last modified the annotation. - `modified_by` string, uri, nullable, required — User that last modified the object. - `modified_at` string, date-time, nullable, required — Timestamp of last modification. - `assigned_at` string, date-time, nullable, required — Timestamp of last assignment to a user or when the annotation was started being annotated. - `confirmed_at` string, date-time, nullable, required — Timestamp when the annotation was moved to status `confirmed`. - `deleted_at` string, date-time, nullable, required — Timestamp when the annotation was moved to status `deleted`. - `exported_at` string, date-time, nullable, required — Timestamp of finished export. - `export_failed_at` string, date-time, nullable, required — Timestamp of failed export. - `purged_at` string, date-time, nullable, required — Timestamp when was annotation purged. - `rejected_at` string, date-time, nullable, required — Timestamp when the annotation was moved to status `rejected`. - `confirmed_by` string, uri, nullable, required — User that confirmed the annotation. - `deleted_by` string, uri, nullable, required — User that deleted the annotation. - `exported_by` string, uri, nullable, required — User that exported the annotation. - `purged_by` string, uri, nullable, required — User that purged the annotation. - `rejected_by` string, uri, nullable, required — User that rejected the annotation. - `rir_poll_id` string, nullable, required — Internal identifier used by Rossum. - `messages` object[], nullable, required — List of messages from the connector (save). - `content` string - `id` integer, nullable - `type` 'error' | 'warning' | 'info' - `content` string, uri, required — Link to annotation content (datapoint values), see [Annotation Content](/api/annotation-content). - `suggested_edit` string, uri, nullable, required — Link to [Suggested edit](/api/suggested-edit) object. - `time_spent` number, float, required — Total time spent while validating the annotation. - `metadata` Metadata, required — Client data. May be used to store e.g. external system object IDs. See [Metadata](/guides/overview#metadata) for more details. - `automated` boolean, required — Whether annotation was [automated](/guides/automation) - `related_emails` string[], required — List of [emails](/api/email) related with annotation. - `email` string, uri, nullable, required — Related [email](/api/email) that the annotation was imported by (for annotations imported by email). - `automation_blocker` string, uri, nullable, required — Related [automation blocker](/api/automation-blocker) object. - `email_thread` string, uri, nullable, required — Related [email thread](/api/email-thread) object. - `has_email_thread_with_replies` boolean — Related email thread contains more than one `incoming` email. - `has_email_thread_with_new_replies` boolean — Related email thread contains an unread `incoming` email. - `organization` string, uri, required — Organization URL. - `automatically_rejected` boolean, required — Indicates whether the annotation was rejected automatically. - `prediction` object, nullable, required — Internal prediction data including engine version info. - `assignees` string[], required — List of assigned users. - `labels` string[], required — List of selected [labels](/api/label). - `restricted_access` boolean, required — Access to annotation is restricted. - `training_enabled` boolean, required — Flag signalling whether the annotation should be used in the training of the instant learning component. ## Other responses - `400` — Invalid input data. - `401` — The username/password is invalid or token is invalid (e.g. expired). - `403` — Insufficient permission, missing authentication, invalid CSRF token and similar issue. - `404` — The specified resource was not found. - `409` — Conflict - `429` — Request rate is too high, wait before sending more requests. See [Rate Limiting](/guides/overview#rate-limiting) for more details. - `500` — Server failure while processing the request. - `502` — Invalid response from the upstream server. - `503` — We're temporarily offline for maintenance. Please try again later. - `504` — Upstream server could not complete the request in time. --- [API](https://skmtc.dev/rossum/apis/rossum-api.md) · [All operations](https://skmtc.dev/rossum/apis/rossum-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rossum/rossum-api/revisions/f1b5a910991d/schema)