One member's usage (usage.read, or yourself)

GET

/api/v1/orgs/{id}/members/{principal}/usage

Team authority: A person reading themselves, or owner/admin, manager or billing; applicable plan and visibility checks remain.

App integration: Request 1–90 UTC days for the complete URL-encoded principal. Do not use another member’s chart when rendering a self-only response. Keep document titles redacted when the server returns only IDs.

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:

orgs:read-List your teams and classrooms and see who is in them

Path Params

Query Params

Responses

🟢200

application/json

Days, totals and org documents worked on in the last 48 hours (titles only where you have access).

Headers

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠404NotFound

🟠429TooManyRequests

🔴500ServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/orgs//members//usage?days=' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "property1": "string",
    "property2": "string"
}

Modified at 2026-10-26 13:12:30

The last 60 minutes per member (admins, managers, billing)

How people collaborate on the org's documents