Skip to main content
GET
/
v2
/
documents
/
{document_id}
cURL
curl https://tavusapi.com/v2/documents/d290f1ee-6c54-4b01-90e6-d701748f0851 \
  -H "x-api-key: YOUR_API_KEY"
{
  "uuid": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "document_name": "Important Document",
  "document_url": "https://example.com/document.pdf",
  "status": "ready",
  "created_at": "2024-01-01T12:00:00Z",
  "updated_at": "2024-01-01T12:05:00Z",
  "callback_url": "https://your-server.com/webhook",
  "tags": [
    "important",
    "meeting"
  ],
  "properties": {
    "department": "sales",
    "priority": "high"
  }
}
Retrieve detailed information about a specific document using its unique identifier.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
document_id
string
required

The unique identifier of the document to retrieve

Response

Document details

​
uuid
string

Unique identifier for the document

Example:

"d290f1ee-6c54-4b01-90e6-d701748f0851"

​
document_name
string

Name of the document

Example:

"Important Document"

​
document_url
string

URL of the document

Example:

"https://example.com/document.pdf"

​
status
string

Current status of the document processing

Example:

"ready"

​
created_at
string

ISO 8601 timestamp of when the document was created

Example:

"2024-01-01T12:00:00Z"

​
updated_at
string

ISO 8601 timestamp of when the document was last updated

Example:

"2024-01-01T12:05:00Z"

​
callback_url
string

URL that receives status updates

Example:

"https://your-server.com/webhook"

​
tags
string[]

Array of document tags

Example:
["important", "meeting"]
​
properties
object

Additional document properties

Example:
{ "department": "sales", "priority": "high" }