---
title: "List Omni Flow Agents"
api: "GET /v1/api/omni-flow-agents"
description: "Retrieve a list of all call agents with all their details."
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

### Headers  

<ParamField header="x-workspace-id" type="string" required>
  Workspace identifier for the API.
</ParamField>

<ResponseExample>
```json
[
  {
    "workspaceId": "674b9687d56a35c024db9cce",
    "userId": "674b9687d56a35c024db9ccc",
    "name": "test",
    "llmModel": "gpt-4o-mini",
    "phoneNumberId": null,
    "status": "ready",
    "createdAt": "2025-01-19T03:18:22.604Z",
    "updatedAt": "2025-01-19T03:18:22.604Z",
    "messageChannel": "SMS"
  },
  {
    "workspaceId": "674b9687d56a35c024db9cce",
    "userId": "674b9687d56a35c024db9ccc",
    "name": "test",
    "llmModel": "gpt-4o-mini",
    "phoneNumberId": {},
    "status": "ready",
    "createdAt": "2025-01-06T09:13:50.282Z",
    "updatedAt": "2025-01-06T09:16:15.796Z",
    "messageChannel": "SMS"
  }
]
```
</ResponseExample>

### Response Fields

<ResponseField name="workspaceId" type="string">
  Workspace ID associated with the agent.
</ResponseField>

<ResponseField name="userId" type="string">
  User ID of the agent creator.
</ResponseField>

<ResponseField name="name" type="string">
  Name of the agent.
</ResponseField>

<ResponseField name="llmModel" type="string">
  Language model used by the agent (e.g., `gpt-4o-mini`).
</ResponseField>

<ResponseField name="phoneNumberId" type="object" nullable>
  The phone number ID associated with the agent, if available.
</ResponseField>

<ResponseField name="status" type="string">
  Current status of the agent (e.g., `ready`).
</ResponseField>

<ResponseField name="createdAt" type="string">
  Timestamp when the agent was created.
</ResponseField>

<ResponseField name="updatedAt" type="string">
  Timestamp when the agent was last updated.
</ResponseField>

<ResponseField name="messageChannel" type="string">
  The channel used by the agent for communication (e.g., `SMS`).
</ResponseField>