List class-owned documents

GET

/api/v1/orgs/{id}/documents

Classroom integration: Returns documents owned by class:, not every personal document belonging to students or every document shared with the class. For human members, teachers and co-teachers have owner-level access, billing and students normally viewer access. A personally granted editor role can matter when opening a specific document. New org-owned tokens receive a role-derived access label here, but individual-document checks identify their own class principal as owner. Do not infer viewer-only service-token authority from this listing label; see the identity guide. Use the shared document API for content and edits, and follow all cursor pages.

Required standing: Membership plus documents:read; token document restrictions also filter results.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

OAuth 2.0

Authorization Code

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Authorize URL: https://handwrites.io/oauth/authorize

Token URL: https://handwrites.io/api/oauth/token

Refresh URL: https://handwrites.io/api/oauth/token

Scopes:

documents:read-List, fetch and download documents, including ones shared with you

Path Params

Query Params

Responses

🟢200

application/json

With your access: managers owner, team members editor, students viewer.

Headers

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠404NotFound

🟠429TooManyRequests

🔴500ServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/orgs//documents?since=&limit=&cursor=' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "documents": [
        {
            "id": "doc_Ab3dEf6hIj9kLm0n",
            "title": "string",
            "language": "en",
            "revision": 0,
            "contentType": "text/plain",
            "contentLength": 0,
            "contentSha256": "string",
            "file": {
                "name": "string",
                "type": "application/pdf",
                "length": 0
            },
            "owner": "user:3f2b…",
            "access": "owner",
            "source": "api",
            "createdAt": "2019-08-24T14:15:22.123Z",
            "updatedAt": "2019-08-24T14:15:22.123Z"
        }
    ],
    "cursor": "string"
}

Modified at 2026-10-26 13:23:27

Documents API — README

README — GET /api/v1/orgs/{id}/billing