Bolt has moved to boltapp.com. Stores still using bolt.com hosts must update now: see the migration guide.

Skip to content

Get a product's plans

View As MarkdownMCP
GET
/v2/subscriptions/products/{productId}/plans

Retrieves the plans of one product. Unlike GET /v1/subscriptions/plans, this endpoint requires both keys and does not fall back to the plans of a global product.

Authorization

X-API-Key<token>

Admins and Developers can obtain their Bolt API key from the Bolt Merchant Dashboard. Send it together with X-Publishable-Key.

In: header

Path Parameters

productId*string

ID of the product to retrieve plans for.

Query Parameters

seller_id?string

Seller ID for Connect marketplace operations. Send it to read a product that belongs to a seller's Bolt Cart division.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/subscriptions/products/sp_Tlj0Osm0N76T/plans"
{  "plans": [    {      "id": "spl_ba_PpkW16oIW",      "name": "Monthly",      "sku": "CANVAS-AI-PRO-MONTHLY",      "created_at": "2023-10-01T12:00:00Z",      "updated_at": "2023-10-01T12:00:00Z",      "frequency": 1,      "frequency_unit": "month",      "base_price": 0,      "product_id": "sp_Tlj0Osm0N76T",      "status": "active",      "currency": "USD",      "initial_period": {        "frequency": 2,        "frequency_unit": "week"      },      "trial": {        "trial_days": 14      }    }  ]}