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

Obtener la información de una cuenta de usuario

Audiencia
public
Autenticación
API key
Permiso
users:read_self

Devuelve en una sola llamada todos los datos recabados del usuario autenticado:

  • Perfil: identificador, correo electrónico, nombre, rol, estado, zona horaria e idioma.
  • Datos de la clave de API: el prefijo y los últimos 4 caracteres, nunca la clave.
  • Datos de la suscripción: el plan, el estado y el fin del periodo en curso.
  • Estado de la autenticación de 2 factores (2FA).
  • Permisos del rol: como lista plana de pares resource:action.
  • Resumen de notificaciones: notificaciones sin leer, envío push y vínculo con Telegram.

Los campos de perfil que solo tienen sentido en una sesión interactiva —el teléfono, el último acceso— se quedan fuera y los sirve GET /v1/users/me/profile-detail.

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 v4).

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

Correo electrónico asociado a la cuenta de usuario (con el que se inicia sesión y se reciben notificaciones).

p. ej. [email protected]
namestring

Nombre con el que se presenta a la cuenta de usuario en la interfaz (máximo 100 caracteres).

p. ej. Carlos Lopez
rolestring

Rol de la cuenta de usuario en la organización. Decide qué permisos tienen sus sesiones — owner: Es la titular; admin: La administra; user: La usa.

p. ej. user
statusstring

Estado de la cuenta de usuario — active: Permite operar con normalidad; suspended: Cuenta suspendida; revoked: Eliminada por el usuario.

p. ej. active
timezonestring

Zona horaria IANA con la que se presentan las fechas al usuario.

p. ej. America/Mexico_City
languagestring | nullanulable

Idioma preferido de la cuenta de usuario para mostrar la interfaz y notificaciones — es: Castellano; en: Inglés; null: La cuenta de usuario aún no ha elegido idioma preferido.

p. ej. es
email_verified_atstring | nullanulable

Fecha y hora de la verificación del correo electrónico de la cuenta de usuario (en ISO 8601 UTC). null cuando sigue pendiente.

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

Fecha y hora del alta de la cuenta de usuario, en ISO 8601 UTC.

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

Datos de la clave de API de la cuenta de usuario. Nunca contiene la clave completa: para eso está POST /v1/users/me/api-key/reveal, que exige la contraseña.

prefixstring

Primeros 8 caracteres de la clave de API.

p. ej. example_
last_4string | nullanulable

Últimos 4 caracteres de la clave de API, con los que se pinta enmascarada (veriko_a1b2••••••f9c2). null en las cuentas anteriores a ese campo, hasta que se rellena.

p. ej. f9c2
subscriptionobject | nullanulable

Suscripción activa de la cuenta de usuario. Cuando no hay ninguna, contiene los valores del plan predeterminado del sistema, y solo es null cuando no se pudo consultar — el caso que _warnings reporta.

plan_slugstring

Identificador único y legible del plan.

p. ej. pro
plan_namestring | nullanulable

Nombre visible del plan activo, tal como lo muestra el catálogo de planes. Es null cuando no se pudo leer el catálogo.

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 cobros pendientes; canceled: Cancelada; paused: En pausa.

p. ej. active
current_period_endstring | nullanulable

Fecha y hora del fin del periodo de facturación en curso, en ISO 8601 UTC.

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

Fecha y hora de la cancelación programada, en ISO 8601 UTC. null cuando no hay ninguna pendiente.

p. ej. null
billing_intervalstring | nullanulable

Cadencia de facturación — once: Ciclo único, sin renovación automática; month: Cada mes; year: Cada año.

p. ej. month
two_factorobject

Estado de la autenticación de 2 factores (2FA).

enabledboolean

true cuando la autenticación de 2 factores (2FA) está activa en la cuenta.

p. ej. false
methodstring | nullanulable

Canal por el que se entrega el código de autenticación (OTP) — sms: Por mensaje de texto; email: Por correo electrónico; null: La cuenta de usuario nunca lo ha configurado. Al desactivar la 2FA se conserva el último canal usado.

p. ej. sms
last_used_atstring | nullanulable

Fecha y hora del último uso de la autenticación de 2 factores (2FA), en ISO 8601 UTC. Campo previsto para más adelante: hoy siempre null.

p. ej. null
permissionsarray

Lista plana de permisos del rol asignado a la cuenta de usuario (en formato resource:action).

notificationsobject

Resumen de la cola de notificaciones del usuario.

unread_countinteger

Cantidad de notificaciones del usuario sin leer ni archivar.

p. ej. 3
push_enabledboolean

true cuando la cuenta tiene al menos una suscripción de notificaciones push activa.

p. ej. false
telegram_linkedboolean

true cuando la cuenta de usuario tiene un chat de Telegram vinculado.

p. ej. false
legal_acceptedboolean

true cuando no queda pendiente la aceptación de ningún documento: ni los Términos de Servicio ni el Aviso de Privacidad. false cuando falta la aceptación de cualquiera de los dos, o cuando el equipo exigió aceptar una versión que la cuenta todavía no ha aceptado. Gatea el modal de consentimiento post-login, que lista lo pendiente en GET /users/me/legal/pending.

p. ej. true
_warningsarray

Piezas que no se pudieron calcular en la respuesta. Solo aparece cuando algo falló, y los campos que dependían de ella llegan en su valor vacío (null o lista vacía).

p. ej. ["subscription_unavailable"]
Códigos de respuestaGET /v1/users/me
CódigoClaseDescripciónCuerpo
2002xxInformación completa del usuario autenticado.UserMeBundle
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
c4d5e6f7a8b99b8a7f6e5d4c