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

# Tap

> Tap at coordinates

Execute a single tap at the specified coordinates.

## Request

```bash theme={null}
curl -X POST https://api.tapkit.ai/v1/phones/{phone_id}/tap \
  -H "X-API-Key: joot_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"x": 100, "y": 200}'
```

### Path Parameters

| Parameter  | Type     | Description          |
| ---------- | -------- | -------------------- |
| `phone_id` | `string` | The phone identifier |

### Query Parameters

| Parameter | Type      | Default | Description                    |
| --------- | --------- | ------- | ------------------------------ |
| `async`   | `boolean` | `false` | Return immediately with job ID |

### Request Body

```json theme={null}
{
  "x": 100,
  "y": 200
}
```

| Field | Type      | Description            |
| ----- | --------- | ---------------------- |
| `x`   | `integer` | X coordinate in pixels |
| `y`   | `integer` | Y coordinate in pixels |

## Response

### Synchronous

```json theme={null}
{
  "id": "job_abc123",
  "status": "completed",
  "result": {},
  "created_at": "2024-01-15T10:30:00Z",
  "completed_at": "2024-01-15T10:30:01Z"
}
```

### Asynchronous

```json theme={null}
{
  "job_id": "job_abc123"
}
```

## Examples

### Basic Tap

```bash theme={null}
curl -X POST https://api.tapkit.ai/v1/phones/abc123/tap \
  -H "X-API-Key: joot_..." \
  -H "Content-Type: application/json" \
  -d '{"x": 585, "y": 1266}'
```

### Python Example

```python theme={null}
import requests

response = requests.post(
    f"https://api.tapkit.ai/v1/phones/{phone_id}/tap",
    headers={
        "X-API-Key": "joot_...",
        "Content-Type": "application/json"
    },
    json={"x": 100, "y": 200}
)

job = response.json()
print(f"Tap completed: {job['status']}")
```

## Related Endpoints

* [Tap by Description](/api-reference/phones/tap-select) - Tap using natural language
* [Double Tap](/api-reference/phones/double-tap) - Double tap gesture
* [Tap and Hold](/api-reference/phones/tap-and-hold) - Long press gesture