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

# Tirdad Cloud

> Get started with Tirdad — the fastest way to integrate usage-based pricing

## Quick Setup

Getting started with Tirdad is straightforward and requires no infrastructure setup. Follow these simple steps:

1. Visit [Tirdad Dashboard](https://app.tirdad.ai/auth)
2. Sign up using either:
   * Google account
   * Email and password

That's it! Your Tirdad instance is ready to use.

## Understanding Environments

When you first log in, you'll be placed in the **Sandbox** environment. Tirdad provides different environments to help you manage your pricing across different stages:

<CardGroup cols={2}>
  <Card title="Sandbox" icon="box">
    A pre-configured environment with sample pricing templates for you to experiment and learn
  </Card>

  <Card title="Production" icon="rocket">
    Your live environment for real customer data and billing
  </Card>
</CardGroup>

## Exploring the Sample Setup

The Sandbox environment comes pre-configured with practical pricing model examples, giving you a starting point for structuring complex pricing:

<Card title="Cursor Pricing Template" icon="book" href="/docs/product-catalogue/plans/use-cases/clone-cursor-pricing">
  Explore the detailed guide on how Cursor's pricing is implemented in Tirdad
</Card>

## Setting up API Keys

To integrate Tirdad with your application, you'll need to generate an API key:

1. Navigate to the **Developers** tab
2. Click **Add** to create a new API key
3. Configure your key:
   * **Name**: Give it a descriptive name (e.g., "Development")
   * **Permissions**: Select "Read & Write"
   * **Expiration**: Choose "Never" for long-term use
4. Click **Create**
5. **Important**: Copy your API key immediately — it will only be shown once!

### Using Your API Key

Include your API key in all requests to the Tirdad API:

```bash theme={null}
curl -X POST https://api.tirdad.ai/v1/customers \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Example Customer", "external_id": "<your-customer-id>"}'
```

<Warning>
  Keep your API key secure and never expose it in client-side code or public repositories.
</Warning>

## Need Help?

If you need assistance or have questions:

* Email us at [support@tirdad.ai](mailto:support@tirdad.ai)