API de Usuario

Obtén el perfil e información de cuenta del usuario autenticado.

La API de Usuario proporciona acceso al perfil y detalles de cuenta del usuario autenticado.

Todos los cuerpos de respuesta utilizan nombres de campo en snake_case.

Endpoints

GET/api/v1/user

Obtener Perfil

GET/api/v1/user

Devuelve el perfil e información de cuenta del usuario actualmente autenticado.

Campos de Respuesta

idstring

ID único del usuario

emailstring

Dirección de email del usuario

first_namestring or null

Nombre del usuario

last_namestring or null

Apellido del usuario

language_preferencestring

Código de idioma preferido (por defecto: "en")

created_atstring

Marca de tiempo ISO 8601 de creación de la cuenta

updated_atstring

Marca de tiempo ISO 8601 de la última actualización

plan_tierstring

Plan actual: "entrepreneur", "pro" o "business"

subscription_statusstring or null

Estado de la suscripción de Stripe (ej., "active", "past_due", "canceled")

current_period_endstring or null

Fecha de fin del período de facturación actual en ISO 8601

storage_used_bytesinteger

Almacenamiento total de archivos consumido en bytes

subdomainstring or null

Subdominio personalizado (ej., "acme" para acme.nueform.io). Plan Pro y superior.

custom_domainstring or null

Dominio personalizado (ej., "forms.acme.com"). Plan Pro y superior.

custom_domain_verified_atstring or null

Marca de tiempo ISO 8601 de cuando el dominio personalizado fue verificado. null si está pendiente.

Respuesta

json

{
  "id": "665a0a1b2c3d4e5f6a7b8c9d",
  "email": "alice@example.com",
  "first_name": "Alice",
  "last_name": "Johnson",
  "language_preference": "en",
  "created_at": "2025-11-01T10:00:00.000Z",
  "updated_at": "2026-02-28T08:15:00.000Z",
  "plan_tier": "pro",
  "subscription_status": "active",
  "current_period_end": "2026-03-15T00:00:00.000Z",
  "storage_used_bytes": 52428800,
  "subdomain": "acme",
  "custom_domain": "forms.acme.com",
  "custom_domain_verified_at": "2026-01-20T14:30:00.000Z"
}

Ejemplos de Código

bash

curl -X GET "https://api.nueform.io/api/v1/user" \
  -H "Authorization: Bearer YOUR_API_KEY"

Respuestas de Error

Respuestas de error estándar devueltas por este endpoint.

Códigos de Error

401Unauthorized

API key faltante o inválida

404Not Found

Usuario no encontrado

500Server Error

Error interno del servidor

Ejemplo de Error

json

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key",
    "status": 401
  }
}

Ultima actualizacion: 6 de abril de 2026