---
title: "Getting started"
description: "Everything you need to send your first uncaptcha.io request."
---

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

# Getting started

uncaptcha.io exposes a small synchronous REST API. Send a challenge to one
endpoint and the completed solution is returned in the same response—there is
no task ID to poll.

- **One endpoint** — Every challenge uses `POST /v1/task/execute`. The `task_type` selects the
solver and determines the shape of `task_data`.
- **Synchronous results** — A successful response contains `data.solution`. Requests have a hard
30-second execution timeout.
- **Charge on success** — Pay-as-you-go balance and bundle quota are restored automatically when a
solve fails or times out.
- **Any HTTP client** — The API is plain JSON over HTTPS. No SDK is required.

## Base URL

```text
https://api.uncaptcha.io/v1
```

All examples in this documentation use the production API.

## Start here

1. [Create an API key and make your first request](/getting-started/quickstart).
2. Read [authentication](/getting-started/authentication) before putting the
   key into production.
3. Choose a [supported task type](/tasks).
4. Handle the [error and billing model](/getting-started/errors-and-billing).

> **API keys are secrets**
>
> Never embed an API key in browser-side JavaScript, a mobile application, or
> a public repository. Send uncaptcha.io requests from a trusted backend.

Source: https://docs.uncaptcha.io/getting-started/index.mdx