title: List Workflows
keywords:

- list workflows
- get
- list
- workflows


# List Workflows

List workflows for the authenticated organization.

#### Query Parameters

**`external_id`** string optional

Filter by external ID

**`active_only`** boolean optional · Defaults to `true`

Return only active workflows

**`limit`** integer optional · Defaults to `100`

Maximum items to return

**`offset`** integer optional · Defaults to `0`

Number of items to skip

## Returns

**`workflows`** array of object

List of workflows

**`total`** integer

Total count

**`limit`** integer

Page size

**`offset`** integer

Page offset

Example

```bash cURL
curl -X GET "https://api.aitronos.com/v1/workflows" \
  -H "X-API-Key: $FREDDY_API_KEY"
```


```python Python
import os
import requests

api_key = os.environ["FREDDY_API_KEY"]

response = requests.get(
    "https://api.aitronos.com/v1/workflows",
    headers={"X-API-Key": api_key}
)

print(response.json())
```


```javascript JavaScript
const apiKey = process.env.FREDDY_API_KEY;

const response = await fetch('https://api.aitronos.com/v1/workflows', {
  method: 'GET',
  headers: {
    'X-API-Key': apiKey
  }
});

const data = await response.json();
console.log(data);
```

**Response:**


```json 200 OK
{
  "workflows": [
    {
      "id": "flow_abc123def456",
      "organization_id": "org_abc123def456",
      "name": "My Resource",
      "definition": {},
      "version": 1,
      "is_active": true,
      "created_at": 1731667800,
      "updated_at": 1731667800
    }
  ],
  "total": 42,
  "limit": 50,
  "offset": 0
}
```

Errors

```json 401 Unauthorized
{
  "success": false,
  "error": {
    "code": "AUTHENTICATION_REQUIRED",
    "message": "Authentication required. Please provide a valid API key.",
    "system_message": "Missing or invalid authorization header",
    "type": "authentication_error",
    "status": 401,
    "trace_id": "req_abc123xyz",
    "timestamp": "2025-11-11T10:30:00Z",
    "details": {}
  }
}
```


```json 403 Forbidden
{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_PERMISSIONS",
    "message": "You do not have permission to access this resource.",
    "system_message": "Insufficient permissions for this operation",
    "type": "authorization_error",
    "status": 403,
    "trace_id": "req_def456uvw",
    "timestamp": "2025-11-11T10:30:00Z",
    "details": {}
  }
}
```

## Related Resources

- [Create Workflow](/docs/api-reference/workflows/create-workflow)
- [Get Workflow](/docs/api-reference/workflows/get-workflow)
- [Update Workflow](/docs/api-reference/workflows/update-workflow)