---
title: "Retrieve Subscription Information"
method: GET
path: "/account/subscription/"
tags: ["Account"]
---

# Retrieve Subscription Information

`GET /account/subscription/`

Details about the accounts subscription (subscribed plan, billing cycle, etc..).

## Response `200`

- AccountSubscriptionOverview — Prepare data for Account Pricing Overview.
  - `plan` Plan, required
    - `id` string, required — Plan identifier.
    - `name` string — Plan name.
    - `family` string, nullable — Plan family.
    - `description` string — Plan description.
    - `is_trial` boolean — Does plan include trial.
    - `charge_model` 'per_unit' | 'flat_fee' | 'volume' | 'tiered', required — * `per_unit` - per_unit * `flat_fee` - flat_fee * `volume` - volume * `tiered` - tiered
    - `price` integer, required
    - `currency_code` 'USD' | 'EUR' | 'GBP', required — * `USD` - USD * `EUR` - EUR * `GBP` - GBP
    - `period` integer — Plan billing is done every N units.
    - `period_unit` 'week' | 'month' | 'year' — Unit for the plan billing cycle. * `week` - Week * `month` - Month * `year` - Year
    - `allowed_builtin_scan_profiles` string[], required
    - `allowed_credits_packs` CreditsPack[], required
      - `id` string, required
      - `name` string, required
      - `price` integer, required
      - `currency_code` 'USD' | 'EUR' | 'GBP' | '', required — * `USD` - USD * `EUR` - EUR * `GBP` - GBP
      - `pack_amount` integer, required
      - `discount` integer, required
      - `savings` integer, required
    - `discount` integer, required
    - `savings` integer, required
    - `tiers` unknown
  - `subscription_status` 'future' | 'in_trial' | 'active' | 'non_renewing' | 'cancelled' | '' — Subscription status * `future` - Future * `in_trial` - In Trial * `active` - Active * `non_renewing` - Non Renewing * `cancelled` - Canceled
  - `has_used_trial` boolean
  - `trial_end` string, date-time, nullable — Date and time the trial period ends.
  - `next_billing_at` string, date-time, nullable — Date and time for next billing cycle.
  - `next_billing_amount` integer — Amount to pay for next subscription renewal (in cents).
  - `plan_amount` integer — Plan cost in cents.
  - `auto_collection` boolean — Auto-collection enabled.
  - `number_free_ultd_targets` integer — Number of promotional targets with unlimited scans.
  - `max_ultd_targets` integer, required
  - `number_paid_ultd_targets` integer — Number of subscribed targets with unlimited scans. DO NOT change this for pro plans!!
  - `number_used_ultd_targets` integer — Number of targets with unlimited scans in use.
  - `number_available_ultd_targets` integer — Number of targets with unlimited scans available.
  - `number_available_ultd_targets_minus_team_quotas` integer — Number of targets with unlimited scans available and which have not been assigned to any team's quota.
  - `number_used_credit_targets` integer, required — Return number of targets that can spend credits.
  - `number_available_credit_targets` integer, required
  - `past_year_ultd_target_changes` integer, required — Number of unlimited scans' target changes in the past year.
  - `max_yearly_ultd_target_changes` integer, required — Maximum number of allowed unlimited scans' target changes in a year.
  - `next_allowed_ultd_target_change` string, date-time, nullable, required — Date time when unlimited scans' target changes are next allowed (if already at maximum).
  - `channel` 'self-service' | 'assisted-sales' | 'partners' | 'resellers' | 'null', nullable — Customer channel * `self-service` - Self Service * `assisted-sales` - Assisted Sales * `partners` - Partners * `resellers` - Resellers
  - `snyk_account_integration_enabled` boolean

## Other responses

- `400`
- `401`
- `500`

---

[API](https://skmtc.net/probely/apis/snyk-api-web-s-api-reference-documentation.md) · [All operations](https://skmtc.net/probely/apis/snyk-api-web-s-api-reference-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/probely/snyk-api-web-s-api-reference-documentation/revisions/e29879bff01b/schema)