> ## Documentation Index
> Fetch the complete documentation index at: https://reach-owl.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /api/v1/app-states — List Connected Accounts

> Returns app-states (connected social account sessions). App-state IDs are used as executor_ids when creating campaigns, post schedulers, and profile growth tasks.

The App States API returns the connected social account sessions for your ReachOwl account. App-state IDs are the values you pass as `executor_id` when creating campaigns, post schedulers, and profile growth tasks. App states are read-only: you cannot create or modify them via the API.

## List App States

### Endpoint

```http theme={null}
GET /api/v1/app-states
```

### Request Example

```bash theme={null}
curl -X GET 'https://reachowl.com/api/v1/app-states' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'
```

### Response Example

```json theme={null}
{
  "data": [
    {
      "id": 5,
      "name": "Main Facebook Account",
      "platform": "facebook",
      "status": "active",
      "created_at": "2024-01-10T08:00:00Z"
    }
  ]
}
```

***

## Get an App State

### Endpoint

```http theme={null}
GET /api/v1/app-states/{id}
```

### Path Parameters

<ParamField path="id" type="integer" required>
  The unique identifier of the app state.
</ParamField>

### Request Example

```bash theme={null}
curl -X GET 'https://reachowl.com/api/v1/app-states/5' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'
```

### Response Example

```json theme={null}
{
  "id": 5,
  "name": "Main Facebook Account",
  "platform": "facebook",
  "status": "active",
  "created_at": "2024-01-10T08:00:00Z"
}
```

<Tip>
  Save app-state IDs as `executor_id` values in your campaign, post scheduler, and profile growth creation requests.
</Tip>

<Note>
  App states are read-only. You cannot add, remove, or modify connected accounts via the API. Manage them in the ReachOwl dashboard.
</Note>

## Error Responses

| Status | Description         |
| ------ | ------------------- |
| 401    | Unauthorized        |
| 404    | App state not found |