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

# List Workflows

> List all workflows for your organization

```
GET /v1/workflows
```

Returns all workflows belonging to your organization, sorted by creation date (newest first).

## Request

### Headers

| Header      | Required | Description  |
| ----------- | -------- | ------------ |
| `x-api-key` | Yes      | Your API key |

### Example request

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.deepidv.com/v1/workflows" \
    -H "x-api-key: YOUR_API_KEY"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.deepidv.com/v1/workflows",
    {
      headers: { "x-api-key": "YOUR_API_KEY" },
    }
  );

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

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

  response = requests.get(
      "https://api.deepidv.com/v1/workflows",
      headers={"x-api-key": "YOUR_API_KEY"},
  )
  ```
</CodeGroup>

## Response

### 200 — Success

| Field                    | Type   | Description                       |
| ------------------------ | ------ | --------------------------------- |
| `workflows`              | array  | Array of workflow summary objects |
| `workflows[].id`         | string | Unique workflow identifier        |
| `workflows[].name`       | string | Workflow name                     |
| `workflows[].created_at` | string | ISO 8601 creation timestamp       |

### Error responses

| Status                  | Description                |
| ----------------------- | -------------------------- |
| `401 Unauthorized`      | Missing or invalid API key |
| `429 Too Many Requests` | Rate limit exceeded        |

<ResponseExample>
  ```json 200 theme={null}
  {
    "workflows": [
      {
        "id": "6d6da499-9225-40fb-9ffd-a06634b915bd",
        "name": "Full Verification",
        "created_at": "2026-03-01T17:30:24.573Z"
      },
      {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "name": "Basic ID Check",
        "created_at": "2026-02-15T09:30:00.000Z"
      }
    ]
  }
  ```
</ResponseExample>
