+Click to view an example of Document Upload API response
+{
+ "id": "31OZMQFW8L1T82WOY8G7WH8TL",
+ "fields": [
+ {
+ "id": "MG8XE61LVYN2UKFYBQXSVI4F3",
+ "name": "updated_at",
+ "type": "timestamp",
+ "values": [ { "label": "2000-01-01T00:00:00.000Z" } ],
+ "label_source": "SYSTEM",
+ "label": "Date Updated",
+ "description": "The date and time the document was last updated"
+ },
+ {
+ "id": "FJI8TLPTERNJIQT6LF3W8MB0Z",
+ "name": "uploaded_at",
+ "type": "timestamp",
+ "values": [ { "label": "2000-01-01T00:00:00.000Z" } ],
+ "label_source": "SYSTEM",
+ "label": "Date Uploaded",
+ "description": "The date and time the document was uploaded to Procore"
+ },
+ {
+ "id": "NFQRRFRI2WXQNDKM8MHFG2FC6",
+ "name": "in_active_workflow",
+ "type": "lov_entry",
+ "values": [ { "id": "TYRCJ5TIQ7ER8WGJXZMOIK9W5", "code": "", "tags": [], "label": "No", "active": true } ],
+ "label_source": "SYSTEM",
+ "label": "In Active Workflow",
+ "description": "Indicates if the document is currently in an active workflow"
+ },
+ {
+ "id": "O1QROZV3IXNPAH2PJ72A4FK9B",
+ "name": "uploaded_by",
+ "type": "reference",
+ "values": [ { "id": "8972757", "code": "", "label": "Jane Doe" } ],
+ "variant": "procore_user",
+ "label_source": "SYSTEM",
+ "label": "Uploaded By",
+ "description": "The person who uploaded the document to Procore"
+ },
+ {
+ "id": "LY9NVSGHOK9OF0TQP5SXS7SNI",
+ "name": "file_size",
+ "type": "string",
+ "values": [ { "label": "405475" } ],
+ "label_source": "SYSTEM",
+ "label": "Size",
+ "description": "The amount of storage or space the document uses"
+ },
+ {
+ "id": "4GZVLETC6T4ESGXW6ZYOX1FV5",
+ "name": "classification",
+ "type": "lov_entry",
+ "values": [],
+ "label_source": "NONE",
+ "label": "Level",
+ "description": "The level of a building or structure"
+ },
+ {
+ "id": "58IC8WRCV30EE1URJHN19TNY1",
+ "name": "workflow_step_due_date",
+ "type": "timestamp",
+ "values": [],
+ "label_source": "NONE",
+ "label": "Workflow Step Due",
+ "description": "The due date for the current workflow step to be completed"
+ },
+ {
+ "id": "64Q03PT52MF8LOWIZ7QKBVGWT",
+ "name": "date_authored",
+ "type": "timestamp",
+ "values": [],
+ "label_source": "ML_FAILED",
+ "confidence_score": 0,
+ "label": "Date Authored",
+ "description": "The date the document was authored"
+ },
+ {
+ "id": "GT6JHAY20I1B8EU8W8OD79ZE7",
+ "name": "originator",
+ "type": "reference",
+ "values": [],
+ "variant": "procore_vendor",
+ "label_source": "SYSTEM",
+ "label": "Originator",
+ "description": "The company that employs the author of a document "
+ },
+ {
+ "id": "TYDBJ9O0KI190ATV1DLMQ2NLZ",
+ "name": "workflow_current_step",
+ "type": "string",
+ "values": [],
+ "label_source": "NONE",
+ "label": "Current Workflow Step",
+ "description": "The Step in the workflow in which the document is currently at"
+ },
+ {
+ "id": "ZCSWZJS8VLG7CQXU8ECGGGG2Y",
+ "name": "discipline",
+ "type": "lov_entry",
+ "values": [],
+ "label_source": "SCRAPING_FAILED",
+ "label": "Discipline",
+ "description": "The discipline associated with this document like architectural, electrical, etc."
+ },
+ {
+ "id": "15WXIWB104E2ZO7O7UBZM55RK",
+ "name": "created_at",
+ "type": "timestamp",
+ "values": [ { "label": "2026-01-14T20:10:05.754Z" } ],
+ "label_source": "SYSTEM",
+ "label": "Created At",
+ "description": "The date the document was created"
+ },
+ {
+ "id": "IUEO5LXJU0MQUK5JA8BYDXUVC",
+ "name": "project_stage",
+ "type": "reference",
+ "values": [],
+ "variant": "procore_project_stage",
+ "label_source": "NONE",
+ "label": "Project Stage",
+ "description": "The construction stage associated with the document. Formerly known as Stage."
+ },
+ {
+ "id": "VPGW834ONMDD9BY5SRJYAJJVS",
+ "name": "location",
+ "type": "reference",
+ "values": [],
+ "variant": "procore_location",
+ "label_source": "NONE",
+ "label": "Location",
+ "description": "Locations associated with the document pulled from Project Locations"
+ },
+ {
+ "id": "NQ7KXAVMU8D7WLGGC230SX51Y",
+ "name": "revision",
+ "type": "string",
+ "values": [ { "label": "1" } ],
+ "label_source": "MANUAL",
+ "label": "Revision",
+ "description": "A printed identification number, letter, or a combination on a document, which may include special characters like hyphens. Mostly used on Drawings and specifications."
+ },
+ {
+ "id": "AI1SJGE010FDKTMITHTS3CRIE",
+ "name": "number",
+ "type": "string",
+ "values": [ { "label": "I" } ],
+ "label_source": "FILENAME_SCRAPING",
+ "label": "Number",
+ "description": "The numerical digits usually located at the end of a document's name"
+ },
+ {
+ "id": "18BXQ6CNKMP508FGW1HXIWHY1",
+ "name": "authored_by",
+ "type": "reference",
+ "values": [ { "id": "8972757", "code": "", "label": "Jane Doe" } ],
+ "variant": "procore_user",
+ "label_source": "SYSTEM",
+ "label": "Authored By",
+ "description": "The person who created the document"
+ },
+ {
+ "id": "9ADT5C4E6NH1WV8QG3CN8P2GP",
+ "name": "updated_by",
+ "type": "reference",
+ "values": [ { "id": "9168335", "code": "", "label": "John Doe" } ],
+ "variant": "procore_user",
+ "label_source": "NONE",
+ "label": "Updated By",
+ "description": "The person who last updated the document"
+ },
+ {
+ "id": "QIZQQ34RPJJ9GRG423CVSGQDP",
+ "name": "assigned_workflow",
+ "type": "reference",
+ "values": [ { "id": "90482", "code": "", "label": "Another Workflow" } ],
+ "variant": "procore_workflow_template_preset",
+ "label_source": "MANUAL",
+ "label": "Assigned Workflow",
+ "description": "The workflow that's selected and in progress for the document"
+ },
+ {
+ "id": "9E6JMUTKDTWFPIIXCQUGB99BP",
+ "name": "original_filename",
+ "type": "string",
+ "values": [ { "label": "TEST4-SP-I-17.pdf" } ],
+ "label_source": "SYSTEM",
+ "label": "File",
+ "description": "The original file name of a document at the time of upload"
+ },
+ {
+ "id": "U7E3CZW8N2IBQ50EHX8SP2F72",
+ "name": "status",
+ "type": "lov_entry",
+ "values": [],
+ "label_source": "NONE",
+ "label": "Status",
+ "description": "The state of a document as it goes through approval, rejection, etc."
+ },
+ {
+ "id": "IKVS7H25PSF3VYD4ZXCRZQNBC",
+ "name": "project",
+ "type": "reference",
+ "values": [ { "id": "2357041", "code": "TEST4", "label": "E2E Testing 1" } ],
+ "variant": "procore_project",
+ "label_source": "SYSTEM",
+ "label": "Project",
+ "description": "An abbreviation of a project's name pulled from the Project Admin tool (Project Code)"
+ },
+ {
+ "id": "7T4FRFO5D2X3JH6XPNE2PYOHW",
+ "name": "workflow_assignees",
+ "type": "reference",
+ "values": [],
+ "variant": "procore_user",
+ "label_source": "NONE",
+ "label": "Workflow Assignees",
+ "description": "All assignees responsible for responding to workflow steps"
+ },
+ {
+ "id": "HGUGVJRTP3BXTD3JVI900NCGY",
+ "name": "description",
+ "type": "rich_text",
+ "values": [ { "label": "MECHANICAL PIPE SCHEDULE" } ],
+ "label_source": "ML",
+ "confidence_score": 0.9999712657370914,
+ "label": "Description",
+ "description": "A brief title for the document"
+ },
+ {
+ "id": "4K1NAV6MC5LLE211F06ICTBJX",
+ "name": "name",
+ "type": "string",
+ "values": [ { "label": "TEST4-SP-I-17" } ],
+ "variant": "computed",
+ "label_source": "SYSTEM",
+ "label": "Name",
+ "description": "A document's unique identifier that can also be configured with a project's requirements"
+ },
+ {
+ "id": "CWGGXADX0Y8R4KVCS4E7W4MZ1",
+ "name": "volume",
+ "type": "lov_entry",
+ "values": [],
+ "label_source": "NONE",
+ "label": "Volume / System",
+ "description": "A complete set of equipment that works together for one role or purpose like a solar-electric system"
+ },
+ {
+ "id": "LRJLVME5FNY5DVU2XO52RBKGQ",
+ "name": "workflow_manager",
+ "type": "reference",
+ "values": [],
+ "variant": "procore_user",
+ "label_source": "NONE",
+ "label": "Workflow Manager",
+ "description": "The person assigned as the manager of the workflow template in which the document is"
+ },
+ {
+ "id": "DMUML7IYWGC4T7UCGCFH477NN",
+ "name": "workflow_current_step_assignees",
+ "type": "reference",
+ "values": [],
+ "variant": "procore_user",
+ "label_source": "NONE",
+ "label": "Current Step Assignees",
+ "description": "The assignee(s) who is currently responsible for responding to the workflow step"
+ },
+ {
+ "id": "52171P4U231QGCNQM1C7BLDO7",
+ "name": "type",
+ "type": "lov_entry",
+ "values": [ { "id": "QQZ6KDZONTRIQQZUR9E7WES29", "code": "SP", "label": "Specification" } ],
+ "label_source": "MANUAL",
+ "label": "Type",
+ "description": "The different categories of documents like drawings, specifications, or models"
+ },
+ {
+ "id": "BVDPYGSC97Q5EKSV7N05G0WRP",
+ "name": "workflow_status",
+ "type": "reference",
+ "values": [],
+ "variant": "procore_workflow_status",
+ "label_source": "NONE",
+ "label": "Workflow Status",
+ "description": "The status of the workflow such as processing, blocked, or complete"
+ },
+ {
+ "id": "K01MXXPC0WPHMQU3KR0R9CC3B",
+ "name": "format",
+ "type": "lov_entry",
+ "values": [ { "id": "BXKQOXKCOBDSD4AEE9SYLITTZ", "code": "application/pdf", "tags": [ "document-service:extension.pdf" ], "label": "PDF", "active": true } ],
+ "label_source": "SYSTEM",
+ "label": "Format",
+ "description": "The file's extension type like EXCEL, PDF, etc."
+ },
+ {
+ "id": "RMOAYBE6GS0WQXOWFJPE9IIHS",
+ "name": "workflow_template_version",
+ "type": "reference",
+ "values": [],
+ "variant": "procore_workflow_template_version",
+ "label_source": "NONE",
+ "label": "Workflow Template Version",
+ "description": "The assigned version of the workflow template as one template may have different versions"
+ },
+ {
+ "id": "GSO8UCN9L69UGF77U92WYJ7KZ",
+ "name": "workflow_pending_assignees",
+ "type": "reference",
+ "values": [],
+ "variant": "procore_user",
+ "label_source": "NONE",
+ "label": "Pending Assignees",
+ "description": "User(s) who must respond before the workflow moves to the next step"
+ },
+ {
+ "id": "GGXB7EVUK46Y42GM2VUL2CM8V",
+ "name": "version",
+ "type": "string",
+ "values": [],
+ "label_source": "SYSTEM",
+ "label": "Version",
+ "description": "Sequential numbers autogenerated by Procore to differentiate every document iteration submitted. This field is not editable."
+ },
+ {
+ "id": "TGQ4R3LJLAW8NRA73PRMUODJJ",
+ "name": "submitted_into_drawings_by",
+ "type": "reference",
+ "values": [],
+ "variant": "procore_user",
+ "label_source": "NONE",
+ "label": "Submitted to Drawings Tool By",
+ "description": "The person who submitted the document into the Drawings tool"
+ },
+ {
+ "id": "WQIBTVNUMBAAZJTIUYS4FTB87",
+ "name": "submitted_into_drawings_at",
+ "type": "timestamp",
+ "values": [],
+ "label_source": "NONE",
+ "label": "Submitted to Drawings Tool At",
+ "description": "The date and time the document was last submitted into the Drawings tool"
+ },
+ {
+ "id": "KS64S7K1MVOW36GM9DGYXME3B",
+ "name": "submitted_into_drawings",
+ "type": "lov_entry",
+ "values": [ { "id": "01JCGGCHGBYW7G9VNWAB61NPK1", "code": "", "tags": [], "label": "No", "active": true } ],
+ "label_source": "SYSTEM",
+ "label": "Submitted to Drawings Tool",
+ "description": "Indicates if the document has been submitted into Drawings tool"
+ },
+ {
+ "id": "LSCNFDDRU1KYDFIZK3L4PHN1S",
+ "name": "workflow_completion_date",
+ "type": "timestamp",
+ "values": [],
+ "label_source": "NONE",
+ "label": "Workflow Completion Date",
+ "description": "The date and time when a document has reached an end step in the last workflow it completed."
+ },
+ {
+ "id": "EMN5K7H0J261EFCFI7VAB66OX",
+ "name": "custom_field_123",
+ "type": "reference",
+ "values": [],
+ "variant": "with_code",
+ "label_source": "NONE",
+ "label": "PDM Custom Field",
+ "description": "-"
+ },
+ {
+ "id": "DQ7EITBYC3RFODDTLMW2ND6LG",
+ "name": "recycled_by",
+ "type": "reference",
+ "values": [],
+ "variant": "procore_user",
+ "label_source": "NONE",
+ "label": "Deleted By",
+ "description": "The person who moved the document to the Recycle Bin"
+ },
+ {
+ "id": "1JTFK2R6MXZVOSF2GNS15HLNA",
+ "name": "recycled_at",
+ "type": "timestamp",
+ "values": [],
+ "label_source": "NONE",
+ "label": "Deleted On",
+ "description": "The date and time the document was moved to the Recycle Bin"
+ },
+ {
+ "id": "4016TXN1O519P83TIU0QYXPPJ",
+ "name": "recycled_reason",
+ "type": "string",
+ "values": [],
+ "label_source": "NONE",
+ "label": "Reason for Deletion",
+ "description": "The reason the document was moved to the Recycle Bin"
+ },
+ {
+ "id": "6RAV5MTW6RGA8O68S2DFA6C6D",
+ "name": "document_stage",
+ "type": "lov_entry",
+ "values": [],
+ "label_source": "NONE",
+ "label": "Document Stage",
+ "description": "The associated stage of the document lifecycle"
+ },
+ {
+ "id": "PBFEZZKTY0MVNX8511L5C6HSA",
+ "name": "action_required",
+ "type": "lov_entries",
+ "values": [],
+ "label_source": "NONE",
+ "label": "Action Required",
+ "description": "The document error which requires action"
+ },
+ {
+ "id": "V362W72BAZ5Z8YOQ1C9543T7Z",
+ "name": "placeholder_assignee",
+ "type": "reference",
+ "values": [],
+ "variant": "procore_user",
+ "label_source": "NONE",
+ "label": "Placeholder Assignee",
+ "description": "The assignee of the placeholder"
+ },
+ {
+ "id": "YQG4KDNVZM7P5R2SJ11KC2UJ1",
+ "name": "placeholder_due_date",
+ "type": "timestamp",
+ "values": [],
+ "label_source": "NONE",
+ "label": "Placeholder Due Date",
+ "description": "The due date of the placeholder"
+ },
+ {
+ "id": "AFFEDVZU6TTQZB6I3PHIG8R5G",
+ "name": "item_content",
+ "type": "lov_entry",
+ "values": [ { "id": "Document", "label": "Document" } ],
+ "label_source": "SYSTEM",
+ "label": "Item Content",
+ "description": "Whether the item is a Document or a Placeholder"
+ }
+ ],
+ "file_key": "KTCLW72UX53NJS3CAW0HKC6Y1",
+ "file_locked": false,
+ "integrations": {
+ "ml_processing": {
+ "errors": [
+ {
+ "source": "revision",
+ "message": "Automatic detection failed. Please enter value manually.",
+ "field_id": "QNSTE3BC36F5WW9IY7N2D5OS0",
+ "reason_code": "LOW_CONFIDENCE"
+ },
+ {
+ "source": "date_authored",
+ "message": "Automatic detection failed. Please enter value manually.",
+ "field_id": "VBTZVW98L2QAZ7DBVGNMG398G",
+ "reason_code": "LOW_CONFIDENCE"
+ }
+ ],
+ "success": [
+ {
+ "source": "type",
+ "field_id": "ZOR1ZWTJ3MHTT0TRTQ9VYBMYE"
+ },
+ {
+ "source": "description",
+ "field_id": "EJ8C9OWGNCPVYQGWYFFXQVRUH"
+ },
+ {
+ "source": "number",
+ "field_id": "UVD3PUHFKB6TBNOHQ2DQRKNL9"
+ }
+ ]
+ },
+ "bim_processing": {
+ "errors": [],
+ "status": "not_applicable",
+ "bim_file_extraction_id": null
+ },
+ "scraping_processing": {
+ "errors": [
+ {
+ "source": "File Format",
+ "message": "File name is incomplete. Add the missing attribute, or rename and reupload the file.",
+ "field_id": "01HKMVPPTHNT7BFZTXQMBXH243",
+ "reason_code": "FILENAME_NOT_CONTAINS_CODE"
+ },
+ {
+ "source": "Location",
+ "message": "File name is incomplete. Add the missing attribute, or rename and reupload the file.",
+ "field_id": "01GR1YE66XAJ28RE3G269PDEPW",
+ "reason_code": "FILENAME_NOT_CONTAINS_CODE"
+ },
+ {
+ "source": "Number",
+ "message": "File name is incomplete. Add the missing attribute, or rename and reupload the file.",
+ "field_id": "01GR1YE6FZ7T1P06055VRTY365",
+ "reason_code": "FILENAME_NOT_CONTAINS_CODE"
+ },
+ {
+ "source": "Originator",
+ "message": "File name is incomplete. Add the missing attribute, or rename and reupload the file.",
+ "field_id": "01GR1YE66XN52RKZK0Z7YE64AT",
+ "reason_code": "FILENAME_NOT_CONTAINS_CODE"
+ },
+ {
+ "source": "Project",
+ "message": "File name is incomplete. Add the missing attribute, or rename and reupload the file.",
+ "field_id": "01GR1YE66XZR3NT0317AKE5NK7",
+ "reason_code": "FILENAME_NOT_CONTAINS_CODE"
+ }
+ ],
+ "success": [
+ {
+ "source": "Description",
+ "field_id": "01GR1YE5XMTKCPM8SPW68Z1E4T"
+ }
+ ]
+ }
+ },
+ "matchCriteria": "TEST4-SP-I-17|application/pdf",
+ "upload_status": "COMPLETED",
+ "integrationStatuses": {
+ "ML": "completed",
+ "FILENAME_SCRAPING": "completed",
+ "integrationResponse": {
+ "type_ML": {
+ "valueId": "YU0H5NUOLP7TA1VLNBQAZIHMG",
+ "valueName": "Drawing"
+ },
+ "number_ML": {
+ "valueId": "MP000",
+ "valueName": "MP000"
+ },
+ "description_ML": {
+ "valueId": "MECHANICAL PIPE SCHEDULE",
+ "valueName": "MECHANICAL PIPE SCHEDULE"
+ },
+ "number_scraping": {
+ "valueId": "I",
+ "valueName": "I"
+ },
+ "date_authored_ML": {
+ "valueId": "2000-01-01T00:00:00.000Z",
+ "valueName": "2000-01-01T00:00:00.000Z"
+ }
+ }
+ },
+ "upload_requested_at": "2000-01-01T00:00:00.000Z",
+ "document_container_id": null,
+ "position_within_container": "aaa....",
+ "download_url": "https://app.procore.com/rest/v1.0/companies/0/projects/0/collaborative_documents/document_uploads/31OZMQFW8L1T82WOY8G7WH8TL/download",
+ "upload_completed_at": "2000-01-01T00:00:01.000Z"
+}
+
+
+
+***