Documents
List documents
Retrieves a paginated list of documents belonging to the
List documents
cURL
curl --request GET \
--url 'https://api.handwritingocr.com/v3/documents?per_page=SOME_INTEGER_VALUE&page=SOME_INTEGER_VALUE' \
--header 'Authorization: Bearer your-api-token' 200 application/json
{
"documents": [
{
"id": "k2D9ZRz9Ob",
"file_name": "My-Document.pdf",
"action": "transcribe",
"page_count": 24,
"status": "processed",
"automatically_deleted_at": "2026-03-12T14:49:19.000000Z",
"created_at": "2026-03-05T14:49:19.000000Z",
"updated_at": "2026-03-05T14:49:19.000000Z"
},
{
"id": "ql78YGv4dE",
"file_name": "Test_Doc_2.pdf",
"action": "transcribe",
"page_count": 36,
"status": "processed",
"automatically_deleted_at": "2026-02-24T14:09:00.000000Z",
"created_at": "2026-02-18T18:37:03.000000Z",
"updated_at": "2026-02-20T00:50:30.000000Z"
}
],
"current_page": 1,
"from": 1,
"to": 2,
"total": 63,
"per_page": 2,
"last_page": 63,
"next_page_url": "https://api.handwritingocr.com/v3/documents?page=2",
"prev_page_url": null
} Retrieves a paginated list of documents belonging to the authenticated user. Documents are sorted by creation date in descending order.
Headers
- Authorization string required header
Bearer your-api-token - Accept string required header
application/json
Query parameters
- per_page integer query
Number of items per page. Default 50, maximum 200.
- page integer query
The page number for pagination. Defaults to 1.
Response codes
HTTP status- 200
Returns a paginated list of documents.
- 401
Unauthorized — invalid or missing API token.
- 422
Validation Error — invalid parameters.