---
title: "Return hosted Stripe billing configuration readiness"
method: GET
path: "/billing/readiness"
---

# Return hosted Stripe billing configuration readiness

`GET /billing/readiness`

## Request

- Base URL: `https://api.gravityads.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gravityads.dev/billing/readiness`
- Auth: HTTP bearer

## Query parameters

- `verify_provider` boolean

## Response `200`

Billing readiness

- object
  - `schema_version` 'gravityads.hosted_billing_readiness.v1', required
  - `status` string, required
  - `tenant_id` string
  - `provider` 'stripe', required
  - `checkout_api_key_configured` boolean
  - `meter_api_key_configured` boolean
  - `webhook_secret_configured` boolean
  - `portal_configuration_configured` boolean
  - `required_price_plans` string[]
  - `configured_price_plans` string[]
  - `configured_price_plan_count` integer
  - `missing_price_plans` string[]
  - `missing_configuration` string[]
  - `configuration_errors` string[]
  - `readiness_checks` object[]
  - `ready_for_checkout` boolean, required
  - `ready_for_customer_portal` boolean, required
  - `ready_for_webhook_ingestion` boolean
  - `ready_for_usage_meter_preview` boolean
  - `ready_for_usage_meter_send` boolean
  - `ready_for_billing_worker` boolean
  - `ready_for_subscription_billing` boolean, required
  - `ready_for_production_billing` boolean
  - `ready_for_external_paid_checkout` boolean
  - `price_intervals` object
    - `monthly` string[]
    - `annual` string[]
  - `tax_readiness` object
    - `status` string
    - `active` boolean, nullable
    - `provider_api_called` boolean
    - `registrations_verified` boolean
  - `hosted_auth_context` object
  - `stripe_api_called` boolean, required
  - `raw_price_ids_returned` false, required
  - `raw_secrets_returned` false, required

---

[API](https://skmtc.dev/gravityads/apis/gravityads-api.md) · [All operations](https://skmtc.dev/gravityads/apis/gravityads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gravityads/apis/gravityads-api/revisions/124cd07d534d?raw)