---
title: "List public USD plans and prices"
method: GET
path: "/plans"
tags: ["Catalog"]
---

# List public USD plans and prices

`GET /plans`

## Request

- Base URL: `https://api.flashdata.dev/v2`
- URL: `https://api.flashdata.dev/v2/plans`
- Auth: none required

## Response `200`

Public plan catalog

- PlanCatalog
  - `trialOffer` PublicTrialOffer
    - `maxApiRequests` integer: Maximum free API calls when the entire trial grant is spent on the lowest-cost per-request API at current Pay as you go rates. Other APIs may allow fewer calls. Downloads are billed by delivered bytes and excluded from this count.
    - `googleSearchRequests` integer, required: Requests if the entire grant is spent on Google sources, using the highest current source rate.
    - `youtubeDataRequests` integer, required: Standard YouTube requests, excluding Extended Search, using the highest current source rate.
    - `downloadGigabytes` number, required: Approximate delivered media volume in decimal GB (1 GB = 1000000000 bytes). Zero when the grant cannot cover the initial download reservation. Completion also depends on per-job reservations and settlement.
  - `data` Plan[], required
    - `id` string, required
    - `slug` string, required
    - `name` string, required
    - `description` string, required
    - `includedCredits` number, required: Credits included in each paid subscription cycle; zero for Pay As You Go.
    - `limits` PlanLimits, required
      - `concurrency` integer, required
      - `maxBatchSize` integer, required
      - `maxPendingJobs` integer, required
    - `prices` PlanPrice[], required
      - `id` string, required
      - `currency` 'USD', required
      - `unitAmount` integer, required: USD cents
      - `credits` number, required: Credits granted by a successful one-time top-up; zero for recurring prices.
      - `type` 'recurring' | 'one_time', required
      - `interval` 'month' | 'year' | 'null', nullable, required
    - `features` string[], required
    - `usagePrices` PlanUsagePrices, required
      - `googlePer1kCents` integer, required: Google request price per 1,000 successful requests, in USD cents.
      - `youtubePer1kCents` integer, required: Standard YouTube request price per 1,000 successful requests, in USD cents.
      - `downloadPerTbCents` integer, required: Download price per decimal TB (1,000,000,000,000 bytes), in USD cents.
  - `currency` 'USD', required
  - `creditValueUsd` number, required: Fixed USD value of one credit, used to preview custom top-ups. The server computes the credited amount.
  - `billingAvailability` 'available' | 'unconfigured' | 'unavailable', required
  - `billingMessage` string, nullable: Stable, non-sensitive explanation suitable for the Pricing and Billing UI.

---

[API](https://skmtc.dev/flashdata/apis/flashdata-customer-api.md) · [All operations](https://skmtc.dev/flashdata/apis/flashdata-customer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flashdata/apis/flashdata-customer-api/revisions/109179fe9313?raw)