Listar usuarios
GET
/v1/partner/usersusers:readLista los usuarios que este partner dio de alta, paginados por cursor
Propósito
Obtiene la lista de todos los usuarios que registraste con POST /users. Solo ves tus usuarios — los de otros partners son invisibles.
Paginación
- Envía
limitpara controlar el tamaño de página (máx 100). - Envía
cursorcon el valor denextCursorde la respuesta anterior para avanzar. - Cuando
nextCursoresnull, ya no hay más páginas.
Parámetros de consulta
limit- Tamaño de página. Default 20, tope 100 aplicado en el repositorio.
cursor- Cursor opaco: el `nextCursor` de la página anterior, tal cual. No es un offset y no se interpreta; basura ⇒ 400 CURSOR_INVALID. En la primera página se omite.
Respuesta 200
Última página: nextCursor en null significa que ya no hay más
itemsarray de PartnerUserResponseDtocreatedAtstringEjemplo:
"2026-09-04T15:04:05.000Z"emailstringEjemplo:
"ana.ramirez@example.com"admite null
Ejemplo:
"tripto-user-4821"admite null
Ejemplo:
"Ana"isActivebooleanEjemplo:
trueadmite null
Ejemplo:
"Ramírez"publicIdstringEjemplo:
"01JKX7PEND0000000000000036"statusstringEjemplo:
"PARTNER_MANAGED"
Cursor de la página siguiente; null si es la última.
admite null
Ejemplo:
"MDFKS1g3TUpQTjAwMDAwMDAwMDAwMDAwMDE"
Errores
| Estado | Códigos | Cuándo |
|---|---|---|
400 | CURSOR_INVALID | Error con code: CURSOR_INVALID |
401 | sin code | Sin x-api-key válida |
403 | sin code | La llave no tiene el scope users:read |
429 | RATE_LIMITED | Limite de uso: 120 por minuto por credencial. Respeta la cabecera `Retry-After`. |