List managed customer accounts
List customer accounts provisioned by the authenticated Developer Application, including Agent and printer health.
What this endpoint does
List customer accounts provisioned by the authenticated Developer Application, including Agent and printer health.
Authentication
Send a one-time RS256 Developer Application assertion in Authorization: Bearer <application_assertion>. This assertion is not a Public API access token.
Request
Production base URL: https://public-api.cloudprint.me/partner-api/v1/accounts
Parameters
| Name | Location | Type | Required | Description | Constraints |
|---|---|---|---|---|---|
limit | query | integer | no | Maximum number of resources to return on one page. | min: 1; max: 100; default: 50 |
cursor | query | string (uuid) | no | Opaque cursor for the requested result page; reuse it unchanged. | — |
external_customer_id | query | string | no | Stable customer identifier from the integrator's system. It must be unique within the authenticated Developer Application. | minLength: 1; maxLength: 160 |
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/partner-api/v1/accounts \
-H "Authorization: Bearer $APPLICATION_ASSERTION"Response
HTTP status: 200 — Managed Accounts page
Response fields
| Name | Type | Required | Description | Constraints |
|---|---|---|---|---|
data | array | yes | Resources returned on the current result page. | — |
next_cursor | string | null (uuid) | yes | Opaque cursor for the next result page; send it back unchanged. | — |
Example response
json
{
"data": [
{
"health": {
"agent_count": 0,
"online_agent_count": 0,
"printer_count": 0,
"online_printer_count": 0,
"last_seen_at": "2026-08-06T12:00:00Z"
},
"relationship_id": "11111111-1111-4111-8111-111111111111",
"developer_account_id": "11111111-1111-4111-8111-111111111111",
"cloudprint_account_id": "11111111-1111-4111-8111-111111111111",
"external_customer_id": "string",
"name": "string",
"application_id": "11111111-1111-4111-8111-111111111111",
"installation_id": "11111111-1111-4111-8111-111111111111",
"agent_enrollment_id": "11111111-1111-4111-8111-111111111111",
"agent_onboarding_expires_at": "2026-08-06T12:00:00Z",
"agent_onboarding_url": "https://connect.cloudprint.me/setup#token=cpat_example",
"onboarding_status": "provisioning",
"status": "provisioning",
"created_at": "2026-08-06T12:00:00Z",
"updated_at": "2026-08-06T12:00:00Z"
}
],
"next_cursor": "11111111-1111-4111-8111-111111111111"
}Errors
| HTTP status | Description |
|---|---|
401 | Application assertion is missing, invalid or already used |
403 | Developer Account production access is not active |
422 | Pagination parameters are invalid |
429 | Rate limit exceeded |
500 | Unexpected error |
Related documentation
Provision a managed customer accountCreate an isolated CloudPrint customer account, App Installation and one-time Agent Enrollment without customer registration.Get one managed customer accountRetrieve one managed customer directly by its stable relationship ID.Managed accounts in CloudPrint Developer PlatformCreate and manage isolated CloudPrint accounts for customers from your own product.