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

# List Workflows

> List all workflows for the authenticated user.

## Authentication

Requires a JWT token or API key in the `Authorization` header.

```bash theme={"dark"}
Authorization: Bearer YOUR_TOKEN
```

## Request

### Query parameters

<ParamField query="page" type="integer">
  Page number (default: 1).
</ParamField>

<ParamField query="limit" type="integer">
  Items per page (default: 20, max: 100).
</ParamField>

<ParamField query="status" type="string">
  Filter by status: `active`, `paused`, or `draft`.
</ParamField>

### Example request

```bash theme={"dark"}
curl "https://encrata.com/api/workflows?status=active&limit=10" \
  -H "Authorization: Bearer YOUR_TOKEN"
```

## Response

Returns a paginated list of workflow objects.

<ResponseField name="workflows" type="array">
  Array of workflow objects.
</ResponseField>

<ResponseField name="workflows[].id" type="string">
  Unique workflow identifier.
</ResponseField>

<ResponseField name="workflows[].name" type="string">
  Workflow display name.
</ResponseField>

<ResponseField name="workflows[].description" type="string">
  Human-readable description.
</ResponseField>

<ResponseField name="workflows[].status" type="string">
  Current status: `active`, `paused`, or `draft`.
</ResponseField>

<ResponseField name="workflows[].trigger" type="object">
  Trigger configuration (type, schedule, etc.).
</ResponseField>

<ResponseField name="workflows[].steps" type="array">
  Array of step definitions.
</ResponseField>

<ResponseField name="workflows[].created_at" type="string">
  ISO 8601 creation timestamp.
</ResponseField>

<ResponseField name="workflows[].updated_at" type="string">
  ISO 8601 last update timestamp.
</ResponseField>

<ResponseField name="total" type="integer">
  Total number of workflows.
</ResponseField>

<ResponseField name="page" type="integer">
  Current page number.
</ResponseField>

### Example response

```json theme={"dark"}
{
  "workflows": [
    {
      "id": "wf_abc123",
      "name": "Enrich new leads",
      "description": "Email lookup → company lookup → webhook",
      "status": "active",
      "trigger": { "type": "webhook" },
      "steps": [
        { "id": "step1", "type": "email_lookup", "config": { "field": "email" } },
        { "id": "step2", "type": "company_lookup", "config": { "field": "step1.company" } },
        { "id": "step3", "type": "webhook", "config": { "url": "https://hooks.example.com/lead" } }
      ],
      "created_at": "2026-05-01T10:00:00Z",
      "updated_at": "2026-05-28T14:30:00Z"
    }
  ],
  "total": 1,
  "page": 1
}
```