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

# Quickstart

# Quickstart

Get started with the VastCap API in just a few steps. This guide will help you make your first captcha-solving request.

## Prerequisites

Before you begin, you'll need:

* A VastCap account (create one at [captcha.vast.sh](https://captcha.vast.sh/signup))
* An API key from your dashboard
* Basic knowledge of HTTP requests

## Step 1: Get Your API Key

1. Log in to your [VastCap Dashboard](https://captcha.vast.sh)
2. Navigate to "API Keys" section
3. Copy your API key

## Step 2: Check Your Balance

Before making captcha-solving requests, make sure your account has sufficient balance:

```bash theme={null}
curl -X POST https://captcha.vast.sh/api/solver/getBalance \
  -H "Content-Type: application/json" \
  -d '{"clientKey": "YOUR_API_KEY"}'
```

## Step 3: Create a Captcha Solving Task

### Here's an example of solving hCaptcha

Both standard and enterprise hCaptcha are solved using `HCaptchaTask`. For enterprise sites (Discord, Epic Games, TikTok, etc), set the `enterprise` parameter to `true`:

```bash theme={null}
curl -X POST https://captcha.vast.sh/api/solver/createTask \
  -H "Content-Type: application/json" \
  -d '{
    "clientKey": "YOUR_API_KEY",
    "task": {
      "type": "HCaptchaTask",
      "websiteURL": "https://discord.com/register",
      "websiteKey": "a9b5fb07-92ff-493f-86fe-352a2803b3df",
      "proxy": "user:pass@ip:port",
      "enterprise": true,
      "invisible": true
    }
  }'
```

## Step 4: Get the Task Result

Use the `taskId` from the previous step to check if the captcha has been solved:

```bash theme={null}
curl -X POST https://captcha.vast.sh/api/solver/getTaskResult \
  -H "Content-Type: application/json" \
  -d '{
    "clientKey": "YOUR_API_KEY",
    "taskId": "TASK_ID_FROM_PREVIOUS_STEP"
  }'
```

The response will include the solution when it's ready.

## Code Examples

### Python

```python theme={null}
import requests
import time

API_KEY = "YOUR_API_KEY"
API_URL = "https://captcha.vast.sh/api/solver"

# Create a new task
task_data = {
    "clientKey": API_KEY,
    "task": {
        "type": "RecaptchaV2Task",
        "websiteURL": "https://example.com/recaptcha",
        "websiteKey": "6LcR_TAUAAAAAMtflUgIXnBu1ldPGo8YlHXKA0fy"
    }
}

response = requests.post(f"{API_URL}/createTask", json=task_data)
task_id = response.json()["taskId"]

# Wait for the result
while True:
    result_data = {
        "clientKey": API_KEY,
        "taskId": task_id
    }
    response = requests.post(f"{API_URL}/getTaskResult", json=result_data)
    result = response.json()
    
    if result.get("status") == "ready":
        print(f"Captcha solved: {result.get('solution', {}).get('gRecaptchaResponse')}")
        break
    
    print("Waiting for solution...")
    time.sleep(3)
```

## Next Steps

Now that you've made your first captcha-solving request, you can explore more advanced options in our API Reference:

* [Authentication](/api-reference/authentication)
* [Create Task](/api-reference/tasks/create-task)
* [Get Task Result](/api-reference/tasks/get-task-result)
* [Get Balance](/api-reference/account/get-balance)