Saltar al contenido
Docs

Referencia

Listar usuarios

GET/v1/partner/usersusers:read

Lista 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 limit para controlar el tamaño de página (máx 100).
  • Envía cursor con el valor de nextCursor de la respuesta anterior para avanzar.
  • Cuando nextCursor es null, 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 PartnerUserResponseDto
    • 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"

  • nextCursorstringpuede venir null

    Cursor de la página siguiente; null si es la última.

    admite null

    Ejemplo: "MDFKS1g3TUpQTjAwMDAwMDAwMDAwMDAwMDE"

Errores

EstadoCódigosCuándo
400CURSOR_INVALIDError con code: CURSOR_INVALID
401sin codeSin x-api-key válida
403sin codeLa llave no tiene el scope users:read
429RATE_LIMITEDLimite de uso: 120 por minuto por credencial. Respeta la cabecera `Retry-After`.