Retrieve Document

GET /api/v1/documents/{id}/

Retrieve details for a specific document by its ID.

Authentication

Requires an API key with documents:read scope. Pass via the X-API-Key header.

Path Parameters

Parameter	Type	Description
`id`	string (UUID)	The unique identifier of the document.

Response

Status: 200 OK

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "filename": "payroll_journal_march.pdf",
  "file_size": 1048576,
  "checksum": "sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "content_type": "application/pdf",
  "created_at": "2026-03-16T12:00:00Z"
}

Response Fields

Field	Type	Description
`id`	string (UUID)	Unique identifier for the document.
`filename`	string	Original filename of the uploaded document.
`file_size`	integer	File size in bytes.
`checksum`	string	SHA-256 checksum of the file.
`content_type`	string	MIME type of the file.
`created_at`	string (ISO 8601)	Timestamp when the document was created.

Errors

Status	Description
`401`	Missing or invalid API key.
`403`	API key does not have `documents:read` scope.
`404`	Document not found.

Code Examples

curl https://api.parsifyhq.com/api/v1/documents/a1b2c3d4-e5f6-7890-abcd-ef1234567890/ \
  -H "X-API-Key: YOUR_API_KEY"

import requests
 
document_id = "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
 
resp = requests.get(
    f"https://api.parsifyhq.com/api/v1/documents/{document_id}/",
    headers={"X-API-Key": "YOUR_API_KEY"},
)
 
print(resp.json())

const documentId = "a1b2c3d4-e5f6-7890-abcd-ef1234567890";
 
const resp = await fetch(
  `https://api.parsifyhq.com/api/v1/documents/${documentId}/`,
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
 
const data = await resp.json();

List Documents Create Job