---
title: "Create checkout session"
method: POST
path: "/v1/billing/checkout"
tags: ["Billing"]
---

# Create checkout session

`POST /v1/billing/checkout`

## Request

- Base URL: `https://api.hempdata.io`
- URL: `https://api.hempdata.io/v1/billing/checkout`
- Auth: none required

Generates a Stripe checkout session URL for subscribing to a plan.

## Request body

- CheckoutRequest
  - `tier` 'starter' | 'professional' | 'enterprise', required: Subscription tier
  - `billing_period` 'monthly' | 'annual', required: Billing frequency
  - `email` string, email, required: Customer email address
  - `success_url` string, uri, required: URL to redirect to after successful payment
  - `cancel_url` string, uri, required: URL to redirect to if payment is cancelled

## Response `200`

Checkout session created

- object
  - `success` boolean
  - `data` object
    - `checkout_url` string, uri
    - `session_id` string

---

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