PDF annotation JSON

Updated On 10 Mar 2025

Print
Dark
Light
PDF

Article summary

Did you find this summary helpful?

Thank you for your feedback

This page describes PDF annotation JSON, a data format for describing PDF data in JavaScript Object Notation (JSON). This JSON code includes the entity's data related to our software and its metadata.

PDF annotation JSON

{
	"annotations": [
		{
  "id": "6763e0935c8f7b03c0b14bf9",
  "datasetId": "64b4d464bdf1fccfe1ba5790",
  "url": "https://gate.dataloop.ai/api/v1/items/6763e0935c8f7b03c0b14bf9",
  "dataset": "https://gate.dataloop.ai/api/v1/datasets/64b4d464bdf1fccfe1ba5790",
  "createdAt": "2024-12-19T09:00:03.273Z",
  "dir": "/",
  "filename": "/PDF Annotations.pdf",
  "type": "file",
  "hidden": false,
  "metadata": {
    "system": {
      "encoding": "7bit",
      "isBinary": true,
      "mimetype": "application/pdf",
      "originalname": "PDF Annotations.pdf",
      "refs": [
        {
          "id": "67b5b7f0a6f018425f8403cd",
          "type": "assignment"
        },
        {
          "id": "67b5b7f0a6f018d9ef8403cb",
          "type": "task"
        }
      ],
      "size": 18020,
      "taskStatusLog": []
    }
  },
  "name": "PDF Annotations.pdf",
  "creator": "user@gmail.com",
  "updatedAt": "2024-12-19T09:00:03.371Z",
  "updatedBy": "user@gmail.com",
  "stream": "https://gate.dataloop.ai/api/v1/items/6763e0935c8f7b03c0b14bf9/stream",
  "thumbnail": "https://gate.dataloop.ai/api/v1/items/6763e0935c8f7b03c0b14bf9/thumbnail",
  "annotations": [
    {
      "id": "67cf29bc47ee8930050bed2f",
      "datasetId": "64b4d464bdf1fccfe1ba5790",
      "itemId": "6763e0935c8f7b03c0b14bf9",
      "url": "https://gate.dataloop.ai/api/v1/annotations/67cf29bc47ee8930050bed2f",
      "item": "https://gate.dataloop.ai/api/v1/items/6763e0935c8f7b03c0b14bf9",
      "dataset": "https://gate.dataloop.ai/api/v1/datasets/64b4d464bdf1fccfe1ba5790",
      "type": "text_mark",
      "label": "sentence-2",
      "attributes": [],
      "coordinates": "featuresofPDFdocumentsistheAnnotations—anumbrellatermthatcoversavarietyofinteractiveobjectsthatcanbeplacedontopofthePDFcontent.",
      "metadata": {
        "system": {
          "attributes": {},
          "automated": false,
          "clientId": "9cd27efb-8062-407f-891f-59b9c1d09053",
          "endFrame": 1,
          "endTime": 0,
          "frame": 0,
          "itemLinks": [],
          "objectId": "1",
          "openAnnotationVersion": "1.91.1-prod.3",
          "recipeId": "6569aa2b27d7bdd0605b8fc9",
          "snapshots_": [],
          "startTime": 0,
          "system": false
        },
        "user": {
          "highlight": {
            "comment": {
              "text": ""
            },
            "content": {
              "text": "featuresofPDFdocumentsistheAnnotations—anumbrellatermthatcoversavarietyofinteractiveobjectsthatcanbeplacedontopofthePDFcontent."
            },
            "id": "sentence-2",
            "position": {
              "boundingRect": {
                "height": 1074.1176470588234,
                "pageNumber": 1,
                "width": 829.9999999999999,
                "x1": 97.63890075683594,
                "x2": 688.3746185302734,
                "y1": 240.00869750976562,
                "y2": 277.8211975097656
              },
              "pageNumber": 1,
              "rects": [
                {
                  "height": 1074.1176470588234,
                  "pageNumber": 1,
                  "width": 829.9999999999999,
                  "x1": 97.63890075683594,
                  "x2": 688.3746185302734,
                  "y1": 240.00869750976562,
                  "y2": 257.2309265136719
                },
                {
                  "height": 1074.1176470588234,
                  "pageNumber": 1,
                  "width": 829.9999999999999,
                  "x1": 97.63890075683594,
                  "x2": 521.1130218505859,
                  "y1": 260.5989685058594,
                  "y2": 277.8211975097656
                }
              ]
            }
          },
          "refs": [
            {
              "entity": "item",
              "ref": "6763e0935c8f7b03c0b14bf9",
              "refBy": "id",
              "rel": "child"
            }
          ]
        }
      },
      "creator": "user@dataloop.ai",
      "createdAt": "2025-03-10T18:04:44.123Z",
      "updatedBy": "user@dataloop.ai",
      "updatedAt": "2025-03-10T18:04:44.123Z",
      "hash": "4e65f74b6295fe695953f47a677c355d3c4cf5cc",
      "source": "ui",
      "description": "featuresofPDFdocumentsistheAnnotations—anumbrellatermthatcoversavarietyofinteractiveobjectsthatcanbeplacedontopofthePDFcontent."
    },
    {
      "id": "67cf29bc47ee8941790bed30",
      "datasetId": "64b4d464bdf1fccfe1ba5790",
      "itemId": "6763e0935c8f7b03c0b14bf9",
      "url": "https://gate.dataloop.ai/api/v1/annotations/67cf29bc47ee8941790bed30",
      "item": "https://gate.dataloop.ai/api/v1/items/6763e0935c8f7b03c0b14bf9",
      "dataset": "https://gate.dataloop.ai/api/v1/datasets/64b4d464bdf1fccfe1ba5790",
      "type": "text_mark",
      "label": "paragraph-1",
      "attributes": [],
      "coordinates": "Intherealworld,theuseofPDFannotationsisvaried.Educatorsoftenusethemtoprovidefeedbackonstudents’work.Inbusiness,theyfacilitatecollaborativedocumentreview,enablingteammemberstoaddcomments,suggestions,orapprovals.Legalprofessionalsuseannotationstoreference",
      "metadata": {
        "system": {
          "attributes": {
            "1": "Yes"
          },
          "automated": false,
          "clientId": "3cfb7221-2e7e-4e9b-b697-63c33e4d9192",
          "endFrame": 1,
          "endTime": 0,
          "frame": 0,
          "itemLinks": [],
          "objectId": "2",
          "openAnnotationVersion": "1.91.1-prod.3",
          "recipeId": "6569aa2b27d7bdd0605b8fc9",
          "snapshots_": [],
          "startTime": 0,
          "system": false
        },
        "user": {
          "highlight": {
            "comment": {
              "text": ""
            },
            "content": {
              "text": "Intherealworld,theuseofPDFannotationsisvaried.Educatorsoftenusethemtoprovidefeedbackonstudents’work.Inbusiness,theyfacilitatecollaborativedocumentreview,enablingteammemberstoaddcomments,suggestions,orapprovals.Legalprofessionalsuseannotationstoreference"
            },
            "id": "paragraph-1",
            "position": {
              "boundingRect": {
                "height": 1074.1176470588234,
                "pageNumber": 1,
                "width": 829.9999999999999,
                "x1": 97.63890075683594,
                "x2": 726.2897186279297,
                "y1": 450.34722900390625,
                "y2": 529.34033203125
              },
              "pageNumber": 1,
              "rects": [
                {
                  "height": 1074.1176470588234,
                  "pageNumber": 1,
                  "width": 829.9999999999999,
                  "x1": 97.63890075683594,
                  "x2": 695.8234710693359,
                  "y1": 450.34722900390625,
                  "y2": 467.5694580078125
                },
                {
                  "height": 1074.1176470588234,
                  "pageNumber": 1,
                  "width": 829.9999999999999,
                  "x1": 97.63890075683594,
                  "x2": 726.2897186279297,
                  "y1": 470.9375305175781,
                  "y2": 488.1597595214844
                },
                {
                  "height": 1074.1176470588234,
                  "pageNumber": 1,
                  "width": 829.9999999999999,
                  "x1": 97.63890075683594,
                  "x2": 659.4998016357422,
                  "y1": 491.5278015136719,
                  "y2": 508.7500305175781
                },
                {
                  "height": 1074.1176470588234,
                  "pageNumber": 1,
                  "width": 829.9999999999999,
                  "x1": 97.63890075683594,
                  "x2": 259.66651916503906,
                  "y1": 512.1181030273438,
                  "y2": 529.34033203125
                }
              ]
            }
          },
          "refs": [
            {
              "entity": "item",
              "ref": "6763e0935c8f7b03c0b14bf9",
              "refBy": "id",
              "rel": "child"
            }
          ]
        }
      },
      "creator": "user@dataloop.ai",
      "createdAt": "2025-03-10T18:04:44.123Z",
      "updatedBy": "user@dataloop.ai",
      "updatedAt": "2025-03-10T18:04:44.123Z",
      "hash": "19962b7b2750ecb30a279fb0bee82d461fd37d36",
      "source": "ui",
      "description": "Intherealworld,theuseofPDFannotationsisvaried.Educatorsoftenusethemtoprovidefeedbackonstudents’work.Inbusiness,theyfacilitatecollaborativedocumentreview,enablingteammemberstoaddcomments,suggestions,orapprovals.Legalprofessionalsuseannotationstoreference"
    }
  ],
  "annotationsCount": 2,
  "annotated": true
}
	]
}

Dictionary Table

Key Name	Definition	Parent Key
id	Unique identifier for the item	Root
datasetId	Identifier for the dataset containing the item	Root
url	API URL to access the item	Root
dataset	API URL to access the dataset	Root
createdAt	Timestamp of when the item was created	Root
dir	Directory path of the item	Root
filename	File name of the item	Root
type	Type of the item (e.g., file)	Root
hidden	Boolean indicating if the item is hidden	Root
metadata	Metadata associated with the item	Root
system	System-related metadata	metadata
encoding	Encoding format of the file	system
isBinary	Boolean indicating if the file is binary	system
mimetype	MIME type of the file	system
originalname	Original name of the file	system
refs	List of references related to the file	system
id	Identifier of the reference	refs
type	Type of reference (e.g., task, assignment)	refs
size	Size of the file in bytes	system
taskStatusLog	Log of task statuses related to the item	system
name	Name of the item	Root
creator	Email of the user who created the item	Root
updatedAt	Timestamp of the last update	Root
updatedBy	Email of the user who updated the item	Root
stream	API URL to stream the item	Root
thumbnail	API URL to access the thumbnail	Root
annotations	List of annotations associated with the item	Root
id	Unique identifier for the annotation	annotations
datasetId	Identifier of the dataset associated with the annotation	annotations
itemId	Identifier of the item being annotated	annotations
url	API URL to access the annotation	annotations
item	API URL to access the annotated item	annotations
dataset	API URL to access the dataset of the annotation	annotations
type	Type of annotation (e.g., text_mark)	annotations
label	Label assigned to the annotation	annotations
attributes	List of attributes assigned to the annotation	annotations
coordinates	Coordinates of the text annotation	annotations
end	Ending position of the annotation in text	coordinates
label	Label associated with the annotation block	coordinates
start	Starting position of the annotation in text	coordinates
type	Type of annotation block	coordinates
metadata	Metadata related to the annotation	annotations
system	System metadata for annotation	metadata
attributes	Additional system attributes	system
automated	Boolean indicating if annotation was automated	system
clientId	Client ID associated with annotation	system
endFrame	End frame of the annotation	system
endTime	End time of the annotation	system
frame	Frame index of the annotation	system
itemLinks	Links to related annotation items	system
objectId	Object ID associated with the annotation	system
openAnnotationVersion	Version of annotation system	system
recipeId	Recipe identifier for annotation	system
snapshots_	Snapshots related to the annotation	system
startTime	Start time of the annotation	system
system	Boolean indicating if annotation is system-generated	system
user	User-related metadata	metadata
creator	Email of the user who created the annotation	annotations
createdAt	Timestamp when annotation was created	annotations
updatedBy	Email of the user who updated the annotation	annotations
updatedAt	Timestamp when annotation was last updated	annotations
hash	Unique hash identifier for annotation	annotations
source	Source of the annotation (e.g., UI)	annotations
annotationsCount	Total count of annotations for the item	Root
annotated	Boolean indicating if the item has annotations	Root

What's Next

RLHF Prompt Studio

Table Of Contents

PDF annotation JSON
Dictionary Table