Documents

List documents

Retrieves a paginated list of documents belonging to the

GET /api/v3/documents Try It

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.