Get current user info

Returns info about the user associated with the access token, including their billing account and current subscription plan.

Required scope: none — any authenticated bearer token (JWT or PAT) can call this endpoint regardless of scope.

GET /api/v1/me

Get current user info

cURL

curl --request GET \
  --url https://formhug.ai/api/v1/me \
  --header 'Authorization: Bearer <token>'

200

{
  "data": {
    "email": "[e-mail]",
    "display_name": "Jane Doe",
    "avatar_url": "https://cdn.example.com/avatars/u.png",
    "created_at": "2024-01-15T08:30:00Z",
    "created_forms_count": 42,
    "entries_count_of_created_forms": 1280,
    "billing_account": {
      "name": "Acme Inc.",
      "current_plan": {
        "code": "free",
        "name": "Free",
        "subscription_period_end": "2026-12-31T23:59:59Z",
        "subscription_cancel_at": null
      }
    }
  }
}

Authorizations

Authorization · string · header · required

Personal Access Token prefixed with fh_. Sent as Authorization: Bearer fh_xxx. The scope required by each endpoint is listed in that endpoint's description.

Response

200

application/json

Current user returned

data · object · required

Show child attributes