Read invitations to the signed-in person

GET

/api/v1/orgs/invitations

Classroom integration: Invitations are matched to the human account verified email. This is not a school roster or an invitation inbox for the student pool. An unverified account does not discover invitations; no verified email means an empty list. Let the person choose whether to join.

Required standing: User identity with matching verified customer email and orgs:read.

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

Responses

🟢200

application/json

Pending invitations.

Headers

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠429TooManyRequests

🔴500ServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/orgs/invitations' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "invitations": [
        {
            "id": "string",
            "organisation": {
                "id": "string",
                "kind": "team",
                "principal": "user:3f2b…",
                "name": "string"
            },
            "role": "owner",
            "invitedBy": "user:3f2b…",
            "status": "pending",
            "createdAt": "2019-08-24T14:15:22.123Z",
            "expiresAt": "2019-08-24T14:15:22.123Z"
        }
    ]
}

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

Invitations API — README

Accept a class invitation