Consultar un usuario

GET/v1/partner/users/{publicId}users:read

Consulta un usuario por su ULID. Ajeno o inexistente responde 404.

Propósito

Obtiene los datos de un usuario específico usando su publicId (ULID de 26 caracteres, devuelto por POST /users).

Seguridad

Solo puedes consultar usuarios que tú diste de alta. Un publicId de otro partner o inexistente responde 404 de forma idéntica — nunca 403, para no revelar que el recurso existe.

Parámetros de ruta

publicId: El usuario, de `POST /users` o de `GET /users`. ULID de 26 caracteres; ajeno o inexistente ⇒ 404 (nunca 403: un 403 confirmaría que existe). Ejemplo: 01JKX7PEND0000000000000036

Respuesta 200

El usuario del partner

createdAtstring
Ejemplo: "2026-09-04T15:04:05.000Z"
emailstring
Ejemplo: "ana.ramirez@example.com"
externalRefstringpuede venir null
admite null
Ejemplo: "tripto-user-4821"
firstNamestringpuede venir null
admite null
Ejemplo: "Ana"
isActiveboolean
Ejemplo: true
lastNamestringpuede venir null
admite null
Ejemplo: "Ramírez"
publicIdstring
Ejemplo: "01JKX7PEND0000000000000036"
statusstring
Ejemplo: "PARTNER_MANAGED"

Errores

Estado	Códigos	Cuándo
`401`	sin code	Sin x-api-key válida
`403`	sin code	La llave no tiene el scope users:read
`404`	`PARTNER_END_USER_NOT_FOUND`	No existe o no es de este partner (un 403 confirmaría que existe)
`429`	`RATE_LIMITED`	Limite de uso: 120 por minuto por credencial. Respeta la cabecera `Retry-After`.