---
title: "Get list of all annotations"
method: GET
path: "/v3/annotations"
tags: ["Annotations"]
---

# Get list of all annotations

`GET /v3/annotations`

Returns your annotations.

## Query parameters

- `document` string, required — Unique identifier for the document

## Response `200`

All matching annotations.

- object
  - `count` integer, required — Number of items in results.
  - `next` string, nullable — URL to request next page of results.
  - `previous` string, nullable — URL to request previous page of results.
  - `results` Annotation[], required
    - `id` integer, required — Annotation's ID
    - `rectangle` Rectangle, required
      - `pageIndex` integer
      - `x0` number, required
      - `y0` number, required
      - `x1` number, required
      - `y1` number, required
    - `rectangles` Rectangle[], required — x/y coordinates for the rectangles containing the data. An annotation can be contained within multiple rectangles.
      - `pageIndex` integer
      - `x0` number, required
      - `y0` number, required
      - `x1` number, required
      - `y1` number, required
    - `document` string, required — Unique identifier for the document
    - `pageIndex` integer, nullable, required — The page number within the document, starting from 0.
    - `raw` string, nullable, required — Raw data extracted from the before any post-processing
    - `confidence` number, nullable, required — The overall confidence that the model's prediction is correct
    - `classificationConfidence` number, nullable, required — The model's confidence that the text has been classified correctly
    - `textExtractionConfidence` number, nullable, required — If the document was submitted as an image, this is the confidence that the text in the image has been correctly read by the model
    - `isVerified` boolean, required — Indicates whether the data has been validated, either by a human using our validation tool or through auto-validation rules
    - `isClientVerified` boolean, required — Indicates whether the data has been validated by a human
    - `isAutoVerified` boolean, required — Indicates whether the data has been auto-validated
    - `dataPoint` string — Data point's identifier
    - `field` string, nullable — Field's identifier
    - `contentType` 'text' | 'integer' | 'float' | 'decimal' | 'date' | 'datetime' | 'daterange' | 'boolean' | 'enum' | 'location' | 'phonenumber' | 'json' | 'table' | 'expectedremuneration' | 'jobtitle' | 'language' | 'skill' | 'yearsexperience' | 'group' | 'table_deprecated' | 'url' | 'image' | 'docclf', required — The different data types of annotations
    - `parent` integer, nullable — The parent annotation's ID

## Other responses

- `400` — Bad request. If it is a validation error will contain a list of each invalid field
- `401` — Authorisation error
- `default` — UnexpectedError

---

[API](https://skmtc.net/affinda/apis/affinda-api-2.md) · [All operations](https://skmtc.net/affinda/apis/affinda-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/affinda/affinda-api-2/versions/6772e50cb58e/schema)
