GEThttps://api.veriko.mx/v1/users/me

Obtener la información completa del usuario actual

Audiencia
public
Autenticación
API key
Permiso
users:read_self

Devuelve la información completa del usuario autenticado: perfil + metadatos de API key + suscripción activa + estado de 2FA + permisos del rol + resumen de notificaciones. Un solo roundtrip reemplaza las llamadas múltiples que el panel hacía antes a /auth/profile, /billing/subscription y /notifications/unread-count.

Petición
curl -X GET 'https://api.veriko.mx/v1/users/me' \
  -H 'Authorization: Bearer veriko_••••'

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

Respuesta 200UserMeBundle — Información completa del usuario autenticado.
CampoTipoDescripción
idstring (uuid)

Identificador único del usuario (UUID v7).

p. ej. b1e4a2c3-1234-4abc-8def-000000000001
emailstring (email)

Correo electrónico del usuario, usado para login y notificaciones.

p. ej. [email protected]
namestring

Nombre completo del usuario tal como aparece en el panel.

p. ej. Carlos Lopez
rolestring

Rol del usuario en la organización. Determina los permisos disponibles. owner — dueño de la cuenta; admin — la administra; user — la usa; viewer — solo consulta.

p. ej. user
statusstring

Estado de la cuenta. Solo active permite operar la API. suspended — cuenta suspendida; pending_verification — falta verificar el correo.

p. ej. active
timezonestring

Zona horaria IANA del usuario, usada para formatear timestamps en la UI.

p. ej. America/Mexico_City
languagestring

Idioma preferido del usuario para UI y notificaciones. es para castellano, en para inglés.

p. ej. es
email_verified_atstring | nullanulable

Timestamp ISO 8601 UTC de cuando el usuario verificó su email. null si pendiente.

p. ej. 2026-04-30T10:15:00Z
created_atstring (date-time)

Timestamp ISO 8601 UTC de creación de la cuenta.

p. ej. 2026-01-15T08:00:00Z
api_keyobject | nullanulable

Metadatos de la API key. Nunca devuelve la key completa (usar POST /v1/users/me/api-key/reveal con password para revelar).

prefixstring

Prefijo de la API key para identificación visual. No incluye la clave completa.

p. ej. example_a1b
last_4string | nullanulable

Últimos 4 caracteres de la API key para render enmascarado (veriko_a1b••••••f9c2). null en cuentas anteriores a que se guardara ese dato, hasta que se rellena.

p. ej. f9c2
subscriptionobject | nullanulable

Suscripción activa del usuario. null si no hay plan activo.

plan_slugstring

Identificador del plan contratado (free, pro, enterprise, etc.).

p. ej. pro
statusstring

Estado actual de la suscripción según el ciclo de facturación. active — al corriente; trialing — en periodo de prueba; past_due — con un cobro pendiente; canceled — cancelada; paused — en pausa.

p. ej. active
current_period_endstring | nullanulable

Fin del periodo de billing actual (ISO 8601 UTC).

p. ej. 2026-06-15T00:00:00Z
cancel_atstring | nullanulable

Fecha programada de cancelación si el usuario inició cancel-at-period-end. null si no hay cancelación pendiente.

p. ej. null
billing_intervalstring | nullanulable

Frecuencia de facturación del plan contratado. month cobra cada mes, year cada año y once marca un cobro único, sin renovación.

p. ej. month
two_factorobject

Estado del segundo factor de autenticación.

enabledboolean

true si el usuario tiene 2FA activado.

p. ej. false
methodstring | nullanulable

Canal de entrega del OTP. null si 2FA está deshabilitado. sms manda el código por mensaje de texto; email, por correo.

p. ej. sms
last_used_atstring | nullanulable

Último uso exitoso del 2FA. Campo futuro, hoy siempre null.

p. ej. null
permissionsarray

Lista plana de permisos del rol del usuario en formato resource:action.

notificationsobject

Resumen de la cola de notificaciones del usuario.

unread_countinteger

Número de notificaciones sin leer ni archivar.

p. ej. 3
push_enabledboolean

true si el usuario tiene al menos una suscripción push activa.

p. ej. false
telegram_linkedboolean

true si el usuario tiene un chat de Telegram vinculado.

p. ej. false
_warningsarray

Lista de subsistemas que fallaron al construir este bundle. Solo presente si hubo fallos parciales. Los campos correspondientes a cada subsistema fallido estarán en su valor por defecto (null o vacío). Permite al cliente degradar gracefully en lugar de mostrar pantalla en blanco.

p. ej. ["subscription_unavailable"]
Códigos de respuestaGET /v1/users/me
CódigoClaseDescripciónCuerpo
2002xxInformación completa del usuario autenticado.Sin cuerpo
4014xxSe requiere autenticación o las credenciales son inválidasErrorResponse
Errores de GET /v1/users/me
CódigoClaveEjemplo
401unauthorized

Credenciales de autenticación ausentes o inválidas.

Envelope
meta.request_id
c4d5e6f7a8b9