---
title: "Subscription"
method: GET
path: "/v1/account/subscription"
tags: ["Workspace"]
---

# Subscription

`GET /v1/account/subscription`

## Request

- Base URL: `https://api.mailbeast.ai`
- URL: `https://api.mailbeast.ai/v1/account/subscription`
- Auth: HTTP bearer

Everything you pay for, grouped by product: your Email Outreach subscription and your separate Lead Finder subscription. Each has its own plan, status, and billing cycle.

Requires one of the following scopes: `usage:read`, `all:read`, `all:all`.

## Response `200`

- SubscriptionResponseDto
  - `emailOutreach` EmailOutreachSubscriptionDto, required
    - `planName` string, required: Your Email Outreach plan.
    - `status` 'active' | 'on_hold' | 'inactive', required: Subscription state: `active`, `on_hold`, or `inactive` (no active subscription - e.g. free plan).
    - `billingInterval` string, nullable, required: `monthly` | `annual` | null.
    - `currentPeriodEnd` string, date-time, nullable, required: When the current paid period ends - it renews then, or ends if `cancelAtPeriodEnd` is true. Null with no active subscription.
    - `cancelAtPeriodEnd` boolean, required
    - `trial` SubscriptionTrialDto, required
      - `isActive` boolean, required
      - `expiresAt` string, date-time, nullable, required
      - `daysRemaining` number, required
    - `addons` SubscriptionAddonsDto, required
      - `contacts` number, required: Extra active-contact capacity.
      - `monthlyEmails` number, required: Extra monthly-email capacity.
      - `aiCredits` number, required: Extra AI credits.
      - `emailValidation` number, required: Extra email-verification credits.
  - `leadFinder` LeadFinderSubscriptionDto, required
    - `tier` 'starter' | 'pro' | 'max', nullable, required: Lead Finder tier, or null if you have no Lead Finder subscription.
    - `status` 'active' | 'on_hold', nullable, required: `active`, `on_hold`, or null (no Lead Finder subscription).
    - `billingInterval` string, nullable, required: `monthly` | `annual` | null.
    - `currentPeriodEnd` string, date-time, nullable, required: When the current Lead Finder paid period ends - its own cycle, independent of the Email Outreach plan.
    - `cancelAtPeriodEnd` boolean, required

## Other responses

- `401`: Missing or invalid API key.
- `403`: The key lacks a required scope, or the plan does not include API access.
- `429`: Rate limit exceeded - retry after the interval in the Retry-After header.

---

[API](https://skmtc.dev/mailbeast/apis/mailbeast-public-api.md) · [All operations](https://skmtc.dev/mailbeast/apis/mailbeast-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mailbeast/apis/mailbeast-public-api/revisions/6440ce0738a4?raw)