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

# List Automations

> Returns every active and inactive automation for the caller, excluding soft-deleted ones, with an optional platform filter for instagram or facebook.

> [!NOTE]
>
> **Beta.** See the [Automations Overview](https://www.ayrshare.com/docs/apis/automations/overview.md) for the full feature description.

Returns every active and inactive automation for the caller. Soft-deleted automations are excluded.

## Header Parameters

**Authorization** `string` *required*

[API Key](https://www.ayrshare.com/docs/apis/overview.md#authorization) of the Primary Profile.

Format: `Authorization: Bearer API_KEY`
**Profile-Key** `string`

[Profile Key](https://www.ayrshare.com/docs/apis/overview.md#profile-key-format) of a User Profile.

Format: `Profile-Key: PROFILE_KEY`

## Query Parameters

**platform** `string`

Optional. Filter to automations targeting this platform: `instagram` or `facebook`.

```bash cURL theme={"system"}
curl \
-H "Authorization: Bearer API_KEY" \
-X GET "https://api.ayrshare.com/api/automations?platform=instagram"
```

```javascript JavaScript theme={"system"}
const API_KEY = "API_KEY";

fetch("https://api.ayrshare.com/api/automations?platform=instagram", {
  method: "GET",
  headers: { "Authorization": `Bearer ${API_KEY}` },
})
  .then((res) => res.json())
  .then((json) => console.log(json))
  .catch(console.error);
```

```python Python theme={"system"}
import requests

headers = {"Authorization": "Bearer API_KEY"}

r = requests.get(
    "https://api.ayrshare.com/api/automations",
    params={"platform": "instagram"},
    headers=headers,
)

print(r.json())
```

```php PHP theme={"system"}
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => "https://api.ayrshare.com/api/automations?platform=instagram",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => ["Authorization: Bearer API_KEY"],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;
```

```json 200: Success theme={"system"}
{
  "status": "success",
  "automations": [
    {
      "id": "auto_9xKp2Lm4nQ",
      "platform": "instagram",
      "accountId": "17841400000000000",
      "name": "Spring promo",
      "description": "",
      "active": true,
      "stats": {
        "totalSent": 42,
        "totalFailed": 1,
        "lastTriggeredAt": "2026-05-12T09:14:22.000Z",
        "lastSentAt": "2026-05-12T09:14:48.000Z"
      },
      "created": "2026-04-30T12:00:00.000Z",
      "updated": "2026-05-12T09:14:48.000Z"
    }
  ]
}
```

```json 403: Plan tier theme={"system"}
{
  "action": "automation",
  "status": "error",
  "code": 468,
  "message": "DM automations require a Business or Enterprise plan"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.