List managed customer accounts
List customer accounts provisioned by the authenticated partner application, including agent and printer health.
What this endpoint does
List customer accounts provisioned by the authenticated partner 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 | — | min: 1; max: 100; default: 50 |
cursor | query | string (uuid) | no | — | — |
external_customer_id | query | string | no | Exact tenant identifier supplied when the managed Account was created. | minLength: 1; maxLength: 160 |
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 | — | — |
next_cursor | string | null (uuid) | yes | Opaque cursor for the next result page; send it back unchanged. | — |
Example response
json
{
"data": [
"string"
],
"next_cursor": null
}Errors
| HTTP status | Description |
|---|---|
401 | Application assertion is missing, invalid or already used |
403 | Partner capability is not granted |
422 | Pagination parameters are invalid |
429 | Rate limit exceeded |
500 | Unexpected error |
Integration guidance
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.CloudPrint Partner PlatformProvision and operate isolated CloudPrint customer accounts from an embedded or white-label product.