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

# Get Automation

> Retrieves a single workflow automation by its ID.

> [!NOTE]
>
> Retrieves a single workflow automation by its ID, including its full `steps` graph and live analytics.

```bash cURL theme={null}
curl --request GET \
  --url https://api.autosend.com/v1/automations/60d5ec49f1b2c72d9c8b9abc \
  --header 'Authorization: Bearer AS_your-project-api-key'
```

```python Python theme={null}
import requests

url = "https://api.autosend.com/v1/automations/60d5ec49f1b2c72d9c8b9abc"

headers = {
    "Authorization": "Bearer AS_your-project-api-key"
}

response = requests.get(url, headers=headers)
print(response.json())
```

```javascript JavaScript theme={null}
fetch('https://api.autosend.com/v1/automations/60d5ec49f1b2c72d9c8b9abc', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer AS_your-project-api-key'
  }
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));
```

```php PHP theme={null}
<?php

$url = 'https://api.autosend.com/v1/automations/60d5ec49f1b2c72d9c8b9abc';

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer AS_your-project-api-key'
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>
```

```go Go theme={null}
package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    url := "https://api.autosend.com/v1/automations/60d5ec49f1b2c72d9c8b9abc"

    req, _ := http.NewRequest("GET", url, nil)
    req.Header.Set("Authorization", "Bearer AS_your-project-api-key")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        fmt.Println("Error:", err)
        return
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}
```

```java Java theme={null}
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;

public class GetWorkflow {
    public static void main(String[] args) {
        try {
            URL url = new URL("https://api.autosend.com/v1/automations/60d5ec49f1b2c72d9c8b9abc");
            HttpURLConnection con = (HttpURLConnection) url.openConnection();

            con.setRequestMethod("GET");
            con.setRequestProperty("Authorization", "Bearer AS_your-project-api-key");

            BufferedReader in = new BufferedReader(new InputStreamReader(con.getInputStream()));
            String inputLine;
            StringBuilder content = new StringBuilder();
            while ((inputLine = in.readLine()) != null) {
                content.append(inputLine);
            }
            in.close();
            con.disconnect();

            System.out.println(content.toString());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}
```

```ruby Ruby theme={null}
require 'net/http'
require 'uri'

uri = URI('https://api.autosend.com/v1/automations/60d5ec49f1b2c72d9c8b9abc')

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer AS_your-project-api-key'

response = http.request(request)
puts response.body
```

```json Response theme={null}
{
  "success": true,
  "data": {
    "id": "60d5ec49f1b2c72d9c8b9abc",
    "projectId": "60d5ec49f1b2c72d9c8b1111",
    "name": "Welcome Series",
    "description": "Sends a 2-email welcome flow when a contact is created",
    "status": "active",
    "entryCriteria": { "type": "contact_created" },
    "exitCriteria": { "type": "workflow_complete" },
    "trackingOpen": true,
    "trackingClick": true,
    "settings": {
      "maxExecutionDays": 60,
      "allowReentry": false,
      "timezone": "UTC",
      "priority": 1
    },
    "steps": [
      { "stepId": "step_aa11", "type": "wait", "delay": { "value": 0, "unit": "minutes" } },
      { "stepId": "step_bb22", "type": "email", "email": { "templateId": "60d5ec49f1b2c72d9c8b1234" } }
    ],
    "tags": ["onboarding"],
    "analytics": {
      "totalEntered": 1250,
      "totalCompleted": 980,
      "totalExited": 40,
      "totalActive": 230
    },
    "activeAt": "2026-05-08T10:00:00.000Z",
    "createdAt": "2026-05-01T08:00:00.000Z",
    "updatedAt": "2026-05-08T10:00:00.000Z"
  }
}
```

***

#### Authorizations

**Authorizations** `string | header` *required*

Project API key header of the form Bearer `AS_<key>`.

### Path Parameters

**id** `string` *required*

Workflow automation ID.

Example: `"60d5ec49f1b2c72d9c8b9abc"`

#### Response

Workflow automation retrieved successfully

**success** `boolean`

Example: `true`

**data** `object`

The workflow automation, with email-step `templateId` references enriched with template metadata where applicable.

**child attributes**

**data.id** `string`

Unique workflow identifier.

**data.projectId** `string`

Project the workflow belongs to.

**data.name** `string`

Display name of the workflow.

**data.description** `string`

Optional description.

**data.status** `string`

Current status: `draft`, `active`, `paused`, or `archived`.

**data.entryCriteria** `object`

Conditions that determine which contacts enter the workflow.

**data.exitCriteria** `object`

Conditions that cause contacts to exit the workflow early.

**data.trackingOpen** `boolean`

Whether open tracking is enabled.

**data.trackingClick** `boolean`

Whether click tracking is enabled.

**data.settings** `object`

Automation configuration settings.

**settings**

**data.settings.maxExecutionDays** `integer`

Maximum number of days a contact can remain active in the workflow.

**data.settings.allowReentry** `boolean`

Whether contacts can re-enter the workflow after completing it.

**data.settings.timezone** `string`

Timezone used for scheduling steps (e.g., `UTC`).

**data.settings.priority** `integer`

Execution priority when multiple automations are triggered simultaneously.

**data.steps** `object[]`

Full ordered step graph, with email steps enriched with template metadata.

**data.tags** `string[]`

Tags for filtering and organization.

**data.analytics** `object`

Live engagement metrics (`totalEntered`, `totalCompleted`, `totalExited`, `totalActive`).

**data.activeAt** `string`

ISO 8601 timestamp when the workflow was last activated.

**data.createdAt** `string`

ISO 8601 creation timestamp.

**data.updatedAt** `string`

ISO 8601 last-updated timestamp.

#### Error Responses

**404 - Workflow not found** `object`

```json theme={null}
{
  "success": false,
  "error": {
    "message": "Workflow automation not found",
    "code": "WORKFLOW_NOT_FOUND"
  }
}
```


## OpenAPI

````yaml GET /automations/{id}
openapi: 3.1.0
info:
  title: AutoSend API
  description: >-
    AutoSend REST API for managing workflow automations. Workflow automations
    send a sequence of emails to contacts based on entry criteria (contact
    created, added to a list, segment match, contact-property match,
    contact-property change, or a custom event). These endpoints accept a
    standard project API key (AS_ prefix).
  version: 1.0.0
servers:
  - url: https://api.autosend.com/v1
security:
  - bearerAuth: []
paths:
  /automations/{id}:
    get:
      summary: Get Automation
      description: Retrieves a single workflow automation by its ID.
components: {}

````

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