---
title: "Retrieve data relevant to creating an API subscription."
method: GET
path: "/manage/api/subscription"
tags: ["manage"]
---

# Retrieve data relevant to creating an API subscription.

`GET /manage/api/subscription`

## Query parameters

- `organization_id` string, required

## Response `200`

API subscription content

- ManageApiSubscriptionResponse
  - `has_accepted_terms` boolean, required — Whether or not the latest required terms have been accepted.
  - `has_stripe_setup` boolean, required — Whether or not Stripe is setup for API usage.
  - `metronome_dashboard_url` string — The URL to display the customer usage dashboard.
  - `metronome_dashboard_dark_mode_url` string — The URL to display the customer usage dashboard, in dark mode.
  - `metronome_links` MetronomeLinks
    - `invoices_iframe_url` string — The URL to display the customer invoice and API usage.
    - `invoices_iframe_dark_mode_url` string — The URL to display the customer invoice and API usage.
    - `credits_iframe_url` string — The URL to display the customer invoice and API usage.
    - `credits_iframe_dark_mode_url` string — The URL to display the customer invoice and API usage.
    - `usage_iframe_url` string — The URL to display the customer usage dashboard.
    - `usage_iframe_dark_mode_url` string — The URL to display the customer usage dashboard, in dark mode.
  - `recharge_settings` RechargeSettingsResponse — The current recharge settings for the API subscription.
    - `top_up_balance` Price, required — Represents a price.
      - `currency_code` string, required — The ISO 4217 currency code for the price object.
      - `amount` number, required — The amount of the currency in the common denomination. For example, in USD this is cents.
    - `minimum_balance_threshold` Price, required — Represents a price.
      - `currency_code` string, required — The ISO 4217 currency code for the price object.
      - `amount` number, required — The amount of the currency in the common denomination. For example, in USD this is cents.
  - `stripe_billing_url` string — The URL for the user to manage the existing Stripe subscription plan.
  - `current_balance` Price, required — Represents a price.
    - `currency_code` string, required — The ISO 4217 currency code for the price object.
    - `amount` number, required — The amount of the currency in the common denomination. For example, in USD this is cents.

## Other responses

- `401` — Not authorized
- `403` — Not authorized

---

[API](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0.md) · [All operations](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ideogram/ideogram-openapi-3-0/versions/bcc2d45be91e/schema)