Get account

GET https://datafa.st/api/v1/admin/account

Return the authenticated account profile, plan status, and billing cycle dates. Use this to verify a token works or to display account context in CLI tools and AI agents.

When authenticated with a df_ website key, the response also includes websiteId for the scoped website.

Request

This endpoint does not require any path, query, or body parameters.

Response

Returns a JSON object with status: "success" and endpoint-specific fields in data.

Response fields

data[]._id

string

User ObjectId.

data[].name

string|null

Human-readable name for the resource or event. The exact meaning depends on the endpoint.

data[].email

string

Account email.

data[].image

string|null

Profile image URL.

data[].hasAccess

boolean

Whether the account has paid access.

data[].planType

string|null

Current plan type.

data[].isFreeTrialActive

boolean

Whether the free trial is active.

data[].freeTrialStartAt

string|null

Free trial start timestamp.

data[].billingCycleStartAt

string|null

Current billing cycle start.

data[].billingCycleEndAt

string|null

Current billing cycle end.

data[].websiteId

string

Website ObjectId used by account tokens to choose which website to query or manage. Only present when authenticated with a single-site website API key.

Authentication

Use a dft_ account token with analytics:read.

Errors

401 — Invalid or missing token.

403 — Account does not have API access.

See API errors for the standard error envelope, auth failures, validation errors, permission errors, and rate limits.

✍️ Something missing? Suggest features.

🤖 AI agent or LLM? Read this page as markdown

{ "status": "success", "data": [{ "_id": "665f0b3c4d2e1a0012345678", "name": "Jane Doe", "email": "jane@example.com", "image": "https://example.com/avatar.png", "hasAccess": true, "planType": "pro", "isFreeTrialActive": false, "freeTrialStartAt": "2026-05-01T00:00:00.000Z", "billingCycleStartAt": "2026-05-01T00:00:00.000Z", "billingCycleEndAt": "2026-06-01T00:00:00.000Z", "createdAt": "2026-01-01T00:00:00.000Z" }] }