---
title: "Create a Stripe Checkout session to subscribe"
method: POST
path: "/api/v1/billing/checkout"
tags: ["Billing & Subscriptions"]
---

# Create a Stripe Checkout session to subscribe

`POST /api/v1/billing/checkout`

## Request

- Base URL: `https://www.deepmapai.com`
- URL: `https://www.deepmapai.com/api/v1/billing/checkout`
- Auth: none declared

Generates a Stripe Checkout URL for upgrading to a paid tier. Redirect the user to the returned URL to complete payment.

## Query parameters

- `x_api_key` string, nullable

## Request body

- ApiStripeBillingCheckoutRequest
  - `tier` string, required: Target tier: builder, pro, or enterprise
  - `success_url` string, nullable: URL to redirect after successful payment
  - `cancel_url` string, nullable: URL to redirect if user cancels

## Response `200`

Successful Response

- CheckoutResponse
  - `checkout_url` string, required: Stripe Checkout URL -- redirect the user here
  - `session_id` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/deepmapai/apis/deepmap-ai.md) · [All operations](https://skmtc.dev/deepmapai/apis/deepmap-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/deepmapai/apis/deepmap-ai/revisions/dab995d977d0?raw)