> ## Documentation Index
> Fetch the complete documentation index at: https://docs.valmi.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Subscriptions

> Manage customer subscriptions

## List Subscriptions

<ParamField path="GET" type="string" required>
  /v1/subscriptions
</ParamField>

List all subscriptions.

<ResponseField name="subscriptions" type="array">
  List of subscriptions
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl -X GET https://api.valmi.io/v1/subscriptions \
    -H "Authorization: Bearer sk_api_abc123xyz"
  ```
</RequestExample>

## Create Subscription

<ParamField path="POST" type="string" required>
  /v1/subscriptions
</ParamField>

Create a new subscription.

### Body

<ParamField body="account_id" type="string" required>
  Account ID
</ParamField>

<ParamField body="rate_plan_id" type="string" required>
  Rate plan ID
</ParamField>

<ParamField body="agent_instance_ids" type="array" required>
  Agent instance IDs to include
</ParamField>

<RequestExample>
  ```bash theme={null}
  curl -X POST https://api.valmi.io/v1/subscriptions \
    -H "Authorization: Bearer sk_api_abc123xyz" \
    -H "Content-Type: application/json" \
    -d '{
      "account_id": "account_abc123",
      "rate_plan_id": "plan_xyz789",
      "agent_instance_ids": ["instance_123"]
    }'
  ```
</RequestExample>