Account

Get your account information including username, credit balance, and subscription status.

Endpoint

GET /api/v1/account

Authentication

Requires a valid API key in the Authorization header.

Authorization: Bearer bw_your_api_key_here

Request

No request body required.

Example Request

curl https://betterwaifu.com/api/v1/account \
  -H "Authorization: Bearer bw_your_api_key_here"

Response

Success Response (200)

{
  "username": "your_username",
  "credits": 150,
  "subscription": {
    "status": "active",
    "plan": "pro",
    "endDate": "2026-04-30T00:00:00.000Z"
  }
}

Response Fields

Field	Type	Description
`username`	string	Your BetterWaifu username
`credits`	number	Current credit balance
`subscription`	object \| null	Subscription details (null if no subscription)
`subscription.status`	string	Subscription status (e.g., "active", "canceled")
`subscription.plan`	string	Subscription plan name
`subscription.endDate`	string	ISO 8601 date when subscription ends

Error Responses

401 Unauthorized

{
  "error": "Invalid or missing API key"
}

404 Not Found

{
  "error": "User not found"
}