---
title: "Read current subscription and credits"
method: GET
path: "/api/billing/subscription"
---

# Read current subscription and credits

`GET /api/billing/subscription`

## Request

- Base URL: `https://api.peelaway.io`
- URL: `https://api.peelaway.io/api/billing/subscription`
- Auth: one of:
  - API key in cookie `better-auth.session_token`
  - HTTP bearer

## Response `200`

Account plan, billingInterval (week, legacy month/year, or null), spendable credits (optionally filtered by output_kind=image|video), and shared paidCredits. weeklyIntroEligible reports eligibility for an introductory deal (the Weekly Plan's paid first week or the Yearly Plan's free trial). introWeekOffer is true once an eligible account has declined a plan offer. Legacy trial and Starter offer eligibility remain false. Future grants are excluded.

## Other responses

- `401`: Authentication required

---

[API](https://skmtc.dev/peelaway/apis/peelaway-image-api.md) · [All operations](https://skmtc.dev/peelaway/apis/peelaway-image-api/llms.txt) · [OpenAPI document](https://skmtc.dev/peelaway/apis/peelaway-image-api/revisions/8ce45533c9d0?raw)