Account Info

Get information about your account and current usage.

Endpoint

GET https://api.thelawin.dev/v1/account

Headers

Header	Required	Description
X-API-Key	Yes	Your API key

Response

{
  "plan": "starter",
  "quota": {
    "total": 500,
    "used": 47,
    "remaining": 453,
    "overage_allowed": 75
  },
  "period": {
    "start": "2026-01-01T00:00:00Z",
    "end": "2026-01-31T23:59:59Z"
  },
  "key": {
    "name": "Production",
    "environment": "live",
    "created_at": "2026-01-01T10:00:00Z",
    "last_used_at": "2026-01-15T14:30:00Z"
  }
}

Response Fields

Plan

Plan	Quota	Price
sandbox	Unlimited	Free
starter	500/month	€19/month
pro	2000/month	€49/month

Quota

Field	Description
total	Total invoices allowed per month
used	Invoices generated this month
remaining	Invoices remaining this month
overage_allowed	Additional invoices allowed on trust (15%)

Period

Field	Description
start	Start of current billing period
end	End of current billing period

Key

Field	Description
name	API key name
environment	sandbox or live
created_at	When the key was created
last_used_at	Last API call with this key

Example

curl https://api.thelawin.dev/v1/account \
  -H "X-API-Key: env_live_xxx"

Using SDKs

TypeScript

const client = new ThelawinClient('env_live_xxx')
const account = await client.getAccount()

console.log(`Used: ${account.quota.used}/${account.quota.total}`)

Python

client = ThelawinClient(api_key="env_live_xxx")
account = client.get_account()

print(f"Used: {account.quota.used}/{account.quota.total}")

Notes

• Sandbox keys always show unlimited quota
• Quota resets at the start of each billing period
• Overage invoices are billed at the end of the month