--- title: "PDF annotation JSON" slug: "pdf-annotation-json" updated: 2025-03-10T18:12:51Z published: 2025-03-10T18:12:51Z canonical: "docs.dataloop.ai/pdf-annotation-json" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.dataloop.ai/llms.txt > Use this file to discover all available pages before exploring further. # PDF annotation JSON 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 | ---