User API

Use the user endpoint to verify an API key and fetch safe account/profile details for the authenticated user.

Authentication

Authorization: Bearer YOUR_ROWSET_API_KEY

Your API base URL is:

https://rowset.lvtd.dev/api

Get current user

GET https://rowset.lvtd.dev/api/user

Example:

curl -H "Authorization: Bearer YOUR_ROWSET_API_KEY" "https://rowset.lvtd.dev/api/user"

Example response:

{
  "email": "you@example.com",
  "profile": {
    "id": 123,
    "state": "signed_up",
    "has_active_subscription": false,
    "trial_status": "active",
    "trial_started_at": "2026-07-13T10:30:00Z",
    "trial_ends_at": "2026-07-20T10:30:00Z"
  }
}

The response does not include your API key.

This authenticated request starts the trial if it has not started already. After the trial ends, authenticated API requests return HTTP 402 with a stable upgrade response:

{
  "code": "TRIAL_EXPIRED",
  "message": "Your Rowset trial has ended. Upgrade to continue using the API, CLI, and MCP.",
  "upgrade_url": "https://rowset.com/pricing",
  "trial_ended_at": "2026-07-20T10:30:00Z"
}

The CLI displays this response, including the upgrade link. MCP tool calls return the same code and upgrade guidance as a non-retryable tool error.

When to use this endpoint

Check that an integration is authenticated correctly.
Give an AI agent a low-risk connectivity test before it works with datasets.
Confirm which Rowset account a key belongs to.

User API

Authentication

Get current user

When to use this endpoint

Related docs