User-API

Profil- und Kontoinformationen des authentifizierten Nutzers abrufen.

Die User-API bietet Zugriff auf das Profil und die Kontodetails des authentifizierten Nutzers.

Alle Antwort-Bodys verwenden Feldnamen in snake_case.

Endpoints

GET/api/v1/user

Profil abrufen

GET/api/v1/user

Gibt die Profil- und Kontoinformationen des aktuell authentifizierten Nutzers zurück.

Antwortfelder

idstring

Eindeutige Nutzer-ID

emailstring

E-Mail-Adresse des Nutzers

first_namestring or null

Vorname des Nutzers

last_namestring or null

Nachname des Nutzers

language_preferencestring

Bevorzugter Sprachcode (Standard: "en")

created_atstring

ISO-8601-Zeitstempel der Kontoerstellung

updated_atstring

ISO-8601-Zeitstempel der letzten Aktualisierung

plan_tierstring

Aktueller Plan: "entrepreneur", "pro" oder "business"

subscription_statusstring or null

Stripe-Abonnementstatus (z. B. "active", "past_due", "canceled")

current_period_endstring or null

ISO-8601-Enddatum des aktuellen Abrechnungszeitraums

storage_used_bytesinteger

Insgesamt verbrauchter Dateispeicher in Bytes

subdomainstring or null

Eigene Subdomain (z. B. "acme" für acme.nueform.io). Ab Pro-Plan.

custom_domainstring or null

Eigene Domain (z. B. "forms.acme.com"). Ab Pro-Plan.

custom_domain_verified_atstring or null

ISO-8601-Zeitstempel der Verifizierung der eigenen Domain. null, wenn ausstehend.

Antwort

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"
}

Codebeispiele

bash

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

Fehlerantworten

Standard-Fehlerantworten, die dieser Endpunkt zurückgibt.

Fehlercodes

401Unauthorized

Fehlender oder ungültiger API-Schlüssel

404Not Found

Nutzer nicht gefunden

500Server Error

Interner Serverfehler

Fehlerbeispiel

json

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

Zuletzt aktualisiert: 20. Juli 2026