List Documents
GET /api/v1/documents/
Returns a paginated list of documents belonging to your organization.
Authentication
Requires an API key with documents:read scope. Pass via the X-API-Key header.
Response
Status: 200 OK
{
"count": 42,
"next": "https://api.parsifyhq.com/api/v1/documents/?page=2",
"previous": null,
"results": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"filename": "payroll_journal_march.pdf",
"file_size": 1048576,
"checksum": "sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"created_at": "2026-03-16T12:00:00Z"
}
]
}Response Fields
| Field | Type | Description |
|---|---|---|
count | integer | Total number of documents. |
next | string or null | URL for the next page of results. |
previous | string or null | URL for the previous page of results. |
results | array | List of document objects. |
Document Object
| 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. |
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. |
Code Examples
curl https://api.parsifyhq.com/api/v1/documents/ \
-H "X-API-Key: YOUR_API_KEY"