---
title: "Get the current API client context"
description: "Confirm which CloudPrint account, client application and scopes are represented by the current access token."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/docs/">CloudPrint Documentation</a><span aria-hidden="true">/</span><span>API reference</span></nav>

# Get the current API client context

<p class="docs-lead">Confirm which CloudPrint account, client application and scopes are represented by the current access token.</p>

<div class="api-endpoint-summary"><span class="api-method api-method-get">GET</span><code>/api/v1/me</code><span><strong>API version:</strong> v1</span><span><strong>operationId:</strong> <code>getApiClientContext</code></span><a href="/docs/api/v1/authentication/client-context/index.md">View as Markdown</a></div>

## 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

This endpoint has no path, query or custom header parameters.

### 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)` | no | Stable identifier of the API credential represented by the current token. | — |
| `client_app_name` | `string \| null` | no | 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`, `app_installation` |
| `installation_id` | `string \| null (uuid)` | yes | Stable UUID of the App Installation that authorized the token. | — |
| `scopes` | `array` | no | 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",
  "client_app_id": null,
  "client_app_name": null,
  "application_id": null,
  "application_name": null,
  "authorization_mode": "client_credentials",
  "installation_id": null,
  "scopes": [
    "agents:read",
    "printers:read",
    "documents:write",
    "print_jobs:write",
    "print_jobs:read"
  ],
  "permissions": [
    "string"
  ]
}
```

## 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

<div class="docs-card-grid"><a class="docs-card" href="/docs/api/v1/authentication/token/"><strong>Get an OAuth2 access token</strong><span>Exchange CloudPrint API credentials for a short-lived OAuth2 Bearer token using the Client Credentials grant.</span></a>
<a class="docs-card" href="/docs/api/v1/agents/list/"><strong>List connected print agents</strong><span>List CloudPrint agents connected to the account and inspect their online status, version and update state.</span></a>
<a class="docs-card" href="/docs/api/v1/printers/list/"><strong>List available printers</strong><span>List printers visible through connected CloudPrint agents and select a stable printer ID for a workflow.</span></a></div>

<nav class="docs-resource-links" aria-label="Next steps"><a href="/docs/api/v1/explorer/">OpenAPI</a><a href="https://my.cloudprint.me">Open account</a><a href="/docs/legal/privacy/">Privacy Policy</a><a href="/docs/legal/terms/">Terms</a><a href="/docs/legal/payments-and-refunds/">Payment and refunds</a><a href="/docs/legal/data-processing/">DPA</a></nav>