Listar cuentas de clientes gestionadas
Consulta las cuentas creadas por la aplicación del partner autenticada, incluido el estado de agentes e impresoras.
GET
/partner-api/v1/accountsVersión de la API: v1operationId: listPartnerManagedAccountsVer como MarkdownQué hace este método
Consulta las cuentas creadas por la aplicación del partner autenticada, incluido el estado de agentes e impresoras.
Autenticación
Envía una aserción RS256 de un solo uso de la Developer Application en Authorization: Bearer <application_assertion>. No es un token de acceso de Public API.
Solicitud
URL de producción: https://public-api.cloudprint.me/partner-api/v1/accounts
Parámetros
| Nombre | Ubicación | Tipo | Obligatorio | Descripción | Restricciones |
|---|---|---|---|---|---|
limit | query | integer | no | Número máximo de recursos que se devuelven en una página. | min: 1; max: 100; default: 50 |
cursor | query | string (uuid) | no | Cursor opaco de la página solicitada; envíalo de nuevo sin modificarlo. | — |
external_customer_id | query | string | no | Identificador estable que el integrador asigna al cliente en su propio sistema. | minLength: 1; maxLength: 160 |
X-Request-Id | header | string | no | Identificador opcional para rastrear la solicitud; CloudPrint devuelve un valor seguro en la cabecera de respuesta. | maxLength: 128; example: "order-100045-attempt-1" |
Cuerpo de la solicitud
El método no tiene cuerpo de solicitud.
Ejemplos de solicitud
cURL
bash
curl -sS https://public-api.cloudprint.me/partner-api/v1/accounts \
-H "Authorization: Bearer $APPLICATION_ASSERTION"Respuesta
Estado HTTP: 200 — Solicitud completada.
Campos de respuesta
| Nombre | Tipo | Obligatorio | Descripción | Restricciones |
|---|---|---|---|---|
data | array | sí | Recursos devueltos en la página actual de resultados. | — |
next_cursor | string | null (uuid) | sí | Cursor opaco de la página siguiente; envíalo de nuevo sin modificarlo. | — |
Ejemplo de respuesta
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"
}Errores
| Estado HTTP | Descripción |
|---|---|
401 | Falta la autenticación o no es válida. |
403 | El token no tiene permisos suficientes. |
422 | Uno o varios campos no son válidos. |
429 | Se superó el límite de solicitudes; respeta Retry-After. |
500 | Error interno de CloudPrint. |
Documentación relacionada
Crear una cuenta de cliente gestionadaCrea una cuenta CloudPrint aislada, una App Installation y un Agent Enrollment de un solo uso sin registro del cliente.Obtener una cuenta de cliente gestionadaRecupera directamente un cliente gestionado mediante el ID estable de la relación.Plataforma para partners de CloudPrintCrea y administra cuentas de CloudPrint separadas para tus clientes desde tu propio producto.