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

# Overview

> Create a temporary Android phone, use it, and end the session.

Phone Harness provides temporary Android phones through an API. Control a phone from your code or open its live viewer in the [dashboard](https://phone-harness.com/dashboard).

## Authentication

Create an account at [phone-harness.com/cloud](https://phone-harness.com/cloud) — sign-up is open and new accounts start with \$5 of credit — then create an API key in the [dashboard](https://phone-harness.com/dashboard/api-keys). Send the key with each authenticated request:

```text theme={null}
Authorization: Bearer YOUR_API_KEY
```

Keep API keys in environment variables or your secret store.

## Base URL

```text theme={null}
https://api.phone-harness.com
```

## The basic workflow

1. [Create a session](/docs/api-reference/sessions/create-session). A `202` response means the request was accepted.
2. [Get the session](/docs/api-reference/sessions/get-session) until its `state` is `ready`.
3. Use the phone through [ADB](/docs/guides/connect-adb) or a [coding agent](/docs/use-cases/connect-coding-agent), and watch it in its [live viewer](/docs/api-reference/phone/get-owner-viewer).
4. [End the session](/docs/api-reference/sessions/end-session) when finished.

```bash Create a phone for 15 minutes theme={null}
curl --fail-with-body -sS https://api.phone-harness.com/sessions \
  -H "Authorization: Bearer $PHONE_HARNESS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"timeout_seconds":900}'
```

The session duration includes provisioning. Billing starts when the phone is ready. Phones cost 5¢ per minute and new accounts start with \$5 of credit; see [Limits and credits](/docs/guides/limits-and-credits). Ending a session deletes its temporary phone and app data.

Each endpoint lists its parameters, request examples, responses, and errors. The [OpenAPI specification](/docs/openapi.json) is also available.