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

# Get Automation

> Fetch one automation by ID, including every attached trigger and action, its active status, and stats such as totalSent and lastTriggeredAt.

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

Returns one automation including every attached trigger and action. Soft-deleted automations return `469` so an attacker probing for IDs gets the same response as a legitimate "not found".

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

## Path Parameters

**id** `string` *required*

The automation ID returned from `POST /automations`.

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

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

fetch(`https://api.ayrshare.com/api/automations/${id}`, {
  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"}
automation_id = "auto_9xKp2Lm4nQ"

r = requests.get(
    f"https://api.ayrshare.com/api/automations/{automation_id}",
    headers=headers,
)

print(r.json())
```

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

curl_setopt_array($curl, [
    CURLOPT_URL => "https://api.ayrshare.com/api/automations/" . $id,
    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",
  "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",
  "triggers": [
    {
      "id": "trg_a1b2c3",
      "type": "comment_keyword",
      "active": true,
      "config": {
        "postId": "17895695668004550",
        "keywords": ["INFO", "LINK"]
      }
    }
  ],
  "actions": [
    {
      "id": "act_d4e5f6",
      "type": "send_dm",
      "active": true,
      "config": {
        "message": "Hey {{recipient_username}}, here is the link you wanted: https://example.com"
      }
    }
  ]
}
```

```json 404: Not found theme={"system"}
{
  "action": "automation",
  "status": "error",
  "code": 469,
  "message": "Automation not found"
}
```


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