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

# List Workflow Templates

> Get a paginated list of workflow templates for the organization.

### Headers

**Authorization** `string` *required*

Bearer token for authentication (e.g., `Bearer <your_token>`).

**X-ORG-ID** `string`

Optional. Use this header only when the authenticated user belongs to multiple organizations. It identifies the organization to target for this action.

### Query Parameters

**page** `integer` (default: 1)

Optional page number for pagination.

**search** `string`

Optional workflow template name to search for.

### Response

**success** `boolean`

Indicates whether the request was successful.

**message** `string`

A descriptive message about the result.

**data** `object`

The workflow templates returned by the request.

**properties**

**templates** `array`

Workflow template records.

**pagination** `object`

Pagination details for the result set.

**properties**

**page** `integer`

Current page number.

**limit** `integer`

Number of templates returned per page.

**total** `integer`

Total number of matching templates.

**totalPages** `integer`

Total number of pages available.

**hasNext** `boolean`

Whether another page is available.

**hasPrev** `boolean`

Whether a previous page is available.

**error** `string`

The error type or code (error responses only).

```json 200 OK theme={null}
{
  "success": true,
  "message": "Workflow templates fetched successfully",
  "data": {
    "templates": [
      {
        "name": "Test_SMS",
        "description": "test",
        "status": true,
        "is_sms": true,
        "is_call": false,
        "is_whatsapp": false,
        "createdAt": "2026-08-06T16:15:46",
        "updatedAt": "2026-08-26T16:13:54",
        "id": "lxdxqJrwjuiQhfCBGFzT"
      }
    ]
  },
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 67,
    "totalPages": 7,
    "hasNext": true,
    "hasPrev": false
  }
}
```

```json 401 Unauthorized theme={null}
{
  "success": false,
  "error": "Unauthorized",
  "message": "Missing or invalid authorization header"
}
```

```json 403 Forbidden theme={null}
{
  "success": false,
  "error": "Forbidden",
  "message": "You don't have the required permission to perform this action"
}
```

```json 500 Server Error theme={null}
{
  "success": false,
  "error": "InternalServerError",
  "message": "An unexpected error occurred"
}
```

## Error Codes

| Status | Description |
| - | - |
| `401` | Unauthorized - missing or invalid authorization header |
| `403` | Forbidden - insufficient permission to list workflow templates |
| `500` | Internal server error |


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