---
title: "CloudPrint API v1 reference"
description: "Build a CloudPrint integration with versioned, indexable documentation for authentication, printers, documents, print jobs, errors and retries."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/docs/">CloudPrint Documentation</a><span aria-hidden="true">/</span><span>API reference</span></nav>

# CloudPrint API v1 reference

<p class="docs-lead">Build a CloudPrint integration with versioned, indexable documentation for authentication, printers, documents, print jobs, errors and retries.</p>

<div class="api-reference-actions"><span><strong>API version:</strong> v1</span><a href="/docs/api/v1/openapi.json">Download OpenAPI v1 JSON</a><a href="/docs/api/v1/explorer/">Open in the interactive API Explorer</a><a href="/docs/api/v1/index.md">View as Markdown</a></div>

## Choose the right documentation

Use the quickstart and workflow guides to understand the complete business flow. Use this versioned API reference while implementing exact requests, fields, responses and errors. The interactive Explorer is a secondary inspection tool; every public operation is documented in static HTML and Markdown.

## Base URL and core flow

Production requests use `https://public-api.cloudprint.me`. A standard integration obtains a token, lists printers, uploads a document, creates an idempotent print job and polls it to a terminal status.

## Compatibility contract

The major version is part of every stable API path. Compatible additions may appear in `v1`; removing or renaming operations, required fields or response fields requires a new major API version.

## What CloudPrint does

CloudPrint delivers print-ready PDF or explicit RAW printer-language data to a selected local printer through an outbound agent connection. It does not generate carrier labels, convert Office documents through Public API or expose the private agent protocol.

## All API v1 operations
| Type | Description | Endpoint |
| --- | --- | --- |
| `POST` | [Get an access token](/docs/api/v1/authentication/token/) | `/oauth/token` |
| `POST` | [Installation access token](/docs/api/v1/app-installations/access-token/) | `/developer-api/v1/app-installations/{installationId}/access-tokens` |
| `GET` | [Agent releases](/docs/api/v1/agent-downloads/releases/) | `/agent-download-api/v1/releases` |
| `GET` | [Download Agent installer](/docs/api/v1/agent-downloads/installer/) | `/agent-download-api/v1/installers/{filename}` |
| `GET` | [List managed accounts](/docs/api/v1/partner/accounts/list/) | `/partner-api/v1/accounts` |
| `POST` | [Provision an account](/docs/api/v1/partner/accounts/create/) | `/partner-api/v1/accounts` |
| `GET` | [Get a managed account](/docs/api/v1/partner/accounts/get/) | `/partner-api/v1/accounts/{relationshipId}` |
| `GET` | [List Agent Enrollments](/docs/api/v1/partner/agent-enrollments/list/) | `/partner-api/v1/accounts/{relationshipId}/agent-enrollments` |
| `POST` | [Create Agent Enrollment](/docs/api/v1/partner/agent-enrollments/create/) | `/partner-api/v1/accounts/{relationshipId}/agent-enrollments` |
| `GET` | [Get Agent Enrollment](/docs/api/v1/partner/agent-enrollments/get/) | `/partner-api/v1/accounts/{relationshipId}/agent-enrollments/{enrollmentId}` |
| `DELETE` | [Revoke Agent Enrollment](/docs/api/v1/partner/agent-enrollments/revoke/) | `/partner-api/v1/accounts/{relationshipId}/agent-enrollments/{enrollmentId}` |
| `GET` | [List managed Agents](/docs/api/v1/partner/agents/list/) | `/partner-api/v1/accounts/{relationshipId}/agents` |
| `DELETE` | [Revoke managed Agent](/docs/api/v1/partner/agents/revoke/) | `/partner-api/v1/accounts/{relationshipId}/agents/{agentId}` |
| `GET` | [Partner usage](/docs/api/v1/partner/usage/) | `/partner-api/v1/usage` |
| `POST` | [Change account state](/docs/api/v1/partner/accounts/change-state/) | `/partner-api/v1/accounts/{relationshipId}/{action}` |
| `GET` | [Client context](/docs/api/v1/authentication/client-context/) | `/api/v1/me` |
| `GET` | [List agents](/docs/api/v1/agents/list/) | `/api/v1/agents` |
| `GET` | [List printers](/docs/api/v1/printers/list/) | `/api/v1/printers` |
| `POST` | [Upload a document](/docs/api/v1/documents/upload/) | `/api/v1/documents` |
| `GET` | [List print jobs](/docs/api/v1/print-jobs/list/) | `/api/v1/print-jobs` |
| `POST` | [Create a print job](/docs/api/v1/print-jobs/create/) | `/api/v1/print-jobs` |
| `POST` | [Create from URL](/docs/api/v1/print-jobs/create-from-url/) | `/api/v1/print-jobs/from-url` |
| `POST` | [Create from Base64](/docs/api/v1/print-jobs/create-from-base64/) | `/api/v1/print-jobs/from-base64` |
| `GET` | [Get job status](/docs/api/v1/print-jobs/get/) | `/api/v1/print-jobs/{printJobId}` |

## 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/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>
<a class="docs-card" href="/docs/api/v1/print-jobs/create/"><strong>Create a print job</strong><span>Send an uploaded CloudPrint document to a selected printer with idempotency and explicit print options.</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>