> ## 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.

# Get Session

> Get details for a specific session

Get the current state and details of a session.

## Request

```bash theme={null}
curl https://api.tapkit.ai/v1/sessions/{session_id} \
  -H "X-API-Key: joot_your_api_key"
```

### Path Parameters

| Parameter    | Type     | Description            |
| ------------ | -------- | ---------------------- |
| `session_id` | `string` | The session identifier |

## Response

**Status: 200 OK**

```json theme={null}
{
  "id": "sess_abc123",
  "phone_id": "abc123-def456",
  "instruction": "Open Instagram and like the first 3 posts",
  "status": "running",
  "cost_usd": null,
  "duration_ms": null,
  "num_turns": 8,
  "error": null,
  "created_at": "2024-01-15T10:30:00Z",
  "started_at": "2024-01-15T10:30:02Z",
  "completed_at": null
}
```

See [Create Session](/api-reference/sessions/create-session) for full response field descriptions.

## Examples

### Python

```python theme={null}
import requests

response = requests.get(
    f"https://api.tapkit.ai/v1/sessions/{session_id}",
    headers={"X-API-Key": "joot_..."}
)

session = response.json()
print(f"Status: {session['status']}, Turns: {session['num_turns']}")
```

## Related Endpoints

* [List Sessions](/api-reference/sessions/list-sessions) - List all sessions
* [Get Events](/api-reference/sessions/get-events) - Poll for session events
* [Stop Session](/api-reference/sessions/stop) - Kill a running session