Get one managed customer account
Retrieve one managed customer directly by its stable relationship ID.
GET
/partner-api/v1/accounts/{relationshipId}API version: v1operationId: getPartnerManagedAccountView as MarkdownWhat this endpoint does
Retrieve one managed customer directly by its stable relationship ID.
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/{relationshipId}
Parameters
| Name | Location | Type | Required | Description | Constraints |
|---|---|---|---|---|---|
relationshipId | path | string (uuid) | yes | Stable UUID of the partner's relationship with the managed customer. | — |
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/$RELATIONSHIP_ID" \
-H "Authorization: Bearer $APPLICATION_ASSERTION"Response
HTTP status: 200 — Managed Account
Response fields
| Name | Type | Required | Description | Constraints |
|---|---|---|---|---|
relationship_id | string (uuid) | yes | Stable UUID of the relationship between the partner and managed customer. | — |
developer_account_id | string (uuid) | yes | Stable UUID of the developer account that owns the customer relationship. | — |
cloudprint_account_id | string (uuid) | yes | Stable UUID of the CloudPrint account created for the managed customer. | — |
external_customer_id | string | yes | Stable customer identifier from the integrator's system. It must be unique within the authenticated Developer Application. | maxLength: 160 |
name | string | yes | Human-readable resource name shown to account operators. | maxLength: 120 |
application_id | string (uuid) | yes | Stable identifier of the Developer Application represented by the installation token. | — |
installation_id | string | null (uuid) | yes | Stable UUID of the App Installation that authorized the token. | — |
agent_enrollment_id | string | null (uuid) | yes | Stable identifier of the Agent Enrollment. | — |
agent_onboarding_expires_at | string | null (date-time) | yes | ISO 8601 timestamp recorded by CloudPrint. | — |
agent_onboarding_url | string | null (uri) | yes | Canonical one-time link for connecting an Agent. Open the complete value unchanged and do not log it. | example: "https://connect.cloudprint.me/setup#token=cpat_example" |
onboarding_status | string | yes | Current readiness state of the managed customer's CloudPrint setup. | enum: provisioning, waiting_for_agent, ready, failed |
status | string | yes | Current resource or workflow state; use the endpoint-specific enum values. | enum: provisioning, active, suspended, closed |
created_at | string (date-time) | yes | ISO 8601 timestamp recorded by CloudPrint. | — |
updated_at | string (date-time) | yes | ISO 8601 timestamp recorded by CloudPrint. | — |
health | object | yes | Aggregated agent and printer health for the managed customer. | — |
Example response
json
{
"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"
}Errors
| HTTP status | Description |
|---|---|
401 | Application assertion is invalid |
403 | Developer Account production access is not active |
404 | Managed Account was not found |
422 | Relationship ID is invalid |
429 | Rate limit exceeded |
500 | Unexpected error |
Related documentation
List managed customer accountsList customer accounts provisioned by the authenticated Developer Application, including Agent and printer health.Create and manage customer accountsAuthenticate Partner API requests, create managed customer accounts, and suspend, resume or close them when needed.List managed customer AgentsList every Agent connected to one managed customer, including revoked Agents.