---
title: "Start a subscription trial"
method: POST
path: "/v1/billing/subscribe"
tags: ["Billing"]
---

# Start a subscription trial

`POST /v1/billing/subscribe`

## Request body

- object
  - `workspace_id` string, required
  - `plan_id` string, required
  - `seats` integer

## Response `201`

Trial started

- object
  - `subscription_id` string
  - `status` 'trialing'
  - `plan` string
  - `seats` integer
  - `trial_ends_at` string, date-time
  - `has_card` boolean

---

[API](https://skmtc.net/shareout/apis/shareout-rest-api.md) · [All operations](https://skmtc.net/shareout/apis/shareout-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shareout/shareout-rest-api/versions/804359ead65a/schema)