POST
Login (email + password)

Overview

Logs in an existing user with email + password and returns an access token (RS256 JWT, 15-min TTL) plus a refresh token (256-bit opaque, 30-day TTL, single-use rotating). The user must have verified their email (emailVerified: true); if not, the response is 403 STATE_CONFLICT with detail: "Email not verified".

Authentication

None required — this is the endpoint that grants authentication.

Path parameters

None.

Query parameters

None.

Request body

Example payload

Response — 200 OK

User object

This is a lightweight summary for rendering the Account header immediately after login. For the full profile (including dateOfBirth and bio), call GET /users/me.
The status fields (onboardingStep, tenancyStatus, subscriptionStatus) are returned lowercased strings in this payload. GET /users/me returns the canonical UPPERCASE enum values for onboardingStatus/tenancyStatus.

Example response

Error responses

Example error — 403 ACCOUNT_PENDING_DELETION

Example error — 401

Side effects

  • Records lastSeenAt on the user document.
  • Creates a refresh_tokens row keyed by the new session id (ULID).

See also

  • Authentication — full token lifecycle, refresh, logout, socket tickets.
  • Errors — the stable error code catalog.

curl