Documents

Retrieve Document

Beta
GET
Retrieve a Document, keying off of either its Vellum-generated ID or its external ID.

Path parameters

idstringRequired
A UUID string identifying this document.

Response

This endpoint returns an object
id
string
last_uploaded_at
datetime
label
string
A human-readable label for the document. Defaults to the originally uploaded file's file name.
document_to_document_indexes
list of objects
external_id
stringOptional
The unique id of this document as it exists in the user's system.
processing_state
enumOptional

The current processing state of the document

  • QUEUED - Queued
  • PROCESSING - Processing
  • PROCESSED - Processed
  • FAILED - Failed
Allowed values: QUEUEDPROCESSINGPROCESSEDFAILED
status
string literalOptional

The current status of the document

  • ACTIVE - Active
Allowed value: ACTIVE
original_file_url
stringOptional
processed_file_url
stringOptional
metadata
map from strings to anyOptional
A previously supplied JSON object containing metadata that can be filtered on when searching.
Built with