Get the current API client context
Confirm which CloudPrint account, client application and scopes are represented by the current access token.
What this endpoint does
Confirm which CloudPrint account, client application and scopes are represented by the current access token.
Authentication
Send a short-lived access token in Authorization: Bearer <access_token>.
Any valid CloudPrint API access token is accepted; no additional scope is required.
Request
Production base URL: https://public-api.cloudprint.me/api/v1/me
Parameters
| Name | Location | Type | Required | Description | Constraints |
|---|---|---|---|---|---|
X-Request-Id | header | string | no | Optional request identifier for tracing; CloudPrint returns a safe value in the response header. | maxLength: 128; example: "order-100045-attempt-1" |
Request body
This endpoint has no request body.
Example requests
cURL
bash
curl -sS https://public-api.cloudprint.me/api/v1/me \
-H "Authorization: Bearer $ACCESS_TOKEN"Response
HTTP status: 200 — Current API client context
Response fields
| Name | Type | Required | Description | Constraints |
|---|---|---|---|---|
account_id | string (uuid) | yes | Stable UUID of the CloudPrint account that owns the resource. | — |
account_name | string | yes | Human-readable CloudPrint account name. | example: "Acme Print Ops" |
client_app_id | string | null (uuid) | yes | Stable identifier of the API credential represented by the current token. | — |
client_app_name | string | null | yes | API credential name used in account diagnostics. | — |
application_id | string | null (uuid) | no | Stable identifier of the Developer Application represented by the installation token. | — |
application_name | string | null | no | Developer Application name shown to account operators. | — |
authorization_mode | string | yes | Authorization model represented by the token: account client credentials or an app installation. | enum: client_credentials |
installation_id | string | null (uuid) | yes | Stable UUID of the App Installation that authorized the token. | — |
scopes | array | yes | Scopes granted to the current access token. | example: ["agents:read","printers:read","documents:write","print_jobs:write","print_jobs:read"] |
permissions | array | no | Permissions approved for the installation and included in this token. | — |
Example response
json
{
"account_id": "11111111-1111-4111-8111-111111111111",
"account_name": "Acme Print Ops",
"authorization_mode": "client_credentials",
"installation_id": "11111111-1111-4111-8111-111111111111",
"client_app_id": "11111111-1111-4111-8111-111111111111",
"client_app_name": "string",
"scopes": [
"agents:read",
"printers:read",
"documents:write",
"print_jobs:write",
"print_jobs:read"
]
}Errors
| HTTP status | Description |
|---|---|
401 | OAuth bearer token is missing, invalid or no longer authorized |
429 | Rate limit exceeded |
500 | Unexpected error |
Integration guidance
- Use this check during onboarding and diagnostics to verify the account and granted scopes.
- Do not call it before every business request; the access token already represents the client context.
Related documentation
Get an OAuth2 access tokenExchange CloudPrint API credentials for a short-lived OAuth2 Bearer token using the Client Credentials grant.List connected print agentsList CloudPrint agents connected to the account and inspect their online status, version and update state.List available printersList printers visible through connected CloudPrint agents and select a stable printer ID for a workflow.