Definition

An Annotation is a field that you can add to a document to collect information from recipients. Annotations can be used to collect signatures, initials, text, checkboxes and dates.

Schema

id
string

Unique identifier of the annotation

recipient_id
string

ID of the recipient

document_id
string

ID of the document

page
integer

Page number where the annotation is placed

x
number

X coordinate of the annotation (in % of the page width from 0 to 100) from the top left corner

y
number

Y coordinate of the annotation (in % of the page height from 0 to 100) from the top left corner

width
number

Width of the annotation (in % of the page width from 0 to 100)

height
number

Height of the annotation (in % of the page height from 0 to 100)

required
boolean

Whether the annotation is required

type
enum<string>

Type of the annotation

Available options:
TEXT,
SIGNATURE,
INITIALS,
CHECKBOX,
DATE
signature
object

Signature annotation (null if annotation is not a signature)

initials
object

Initials annotation (null if annotation is not initials)

text
object

Text annotation (null if annotation is not a text)

datetime
object

Date annotation (null if annotation is not a date)

checkbox
object

Checkbox annotation (null if annotation is not a checkbox)