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

# Outreach: List Stages

> List the prospect stages set up in Outreach with their IDs. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

List the prospect stages set up in Outreach with their IDs.

> [!NOTE]
>
> Tool ID: `outreach_list_stages`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'outreach_list_stages',
  {
    "newFilterSyntax": true,
    "page_size": 123,
    "page_after": "cursor_123"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute outreach_list_stages --input '{
  "newFilterSyntax": true,
  "page_size": 123,
  "page_after": "cursor_123"
}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "data": [
      {
        "attributes": {
          "color": "example",
          "createdAt": "2026-01-15T12:00:00Z",
          "name": "Example"
        },
        "id": 123,
        "relationships": {
          "creator": {},
          "prospects": {},
          "updater": {}
        }
      }
    ]
  }
}
```

Use `deepline describe outreach_list_stages --json` for the latest machine-readable contract.

## Input reference

Get a Collection of Stages

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.newFilterSyntax` | `boolean` | No | — | Use Outreach array/range filter syntax for literal commas and ranges. |
| `payload.page_size` | `integer` | No | — | Cursor page size sent as page\[size]. Minimum: 1. Maximum: 1000. |
| `payload.page_after` | `string` | No | — | Cursor returned by the previous page. |
| `payload.page_before` | `string` | No | — | Cursor returned by the next page. |
| `payload.page_limit` | `integer` | No | — | Deprecated offset-pagination limit sent as page\[limit]. Prefer page\_size. Minimum: 1. Maximum: 1000. |
| `payload.page_offset` | `integer` | No | — | Deprecated offset-pagination offset sent as page\[offset]. Prefer cursors. Minimum: 0. Maximum: 10000. |
| `payload.count` | `boolean` | No | — | Request Outreach total-count metadata. false is faster for pagination. |
| `payload.sort` | `string` | No | — | Comma-separated sortable fields. prefix a field with - for descending order. |
| `payload.include` | `string` | No | — | Comma-separated related resources to include. |
| `payload.fields` | `object` | No | — | Sparse fieldsets keyed by JSON:API resource type, sent as fields\[resource]. |
| `payload.filters` | `object` | No | — | Endpoint-specific Outreach filters. Relationship attributes use keys such as owner\[id]. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Get a Collection of Stages",
    "properties": {
      "newFilterSyntax": {
        "type": "boolean",
        "description": "Use Outreach array/range filter syntax for literal commas and ranges."
      },
      "page_size": {
        "type": "integer",
        "description": "Cursor page size sent as page[size].",
        "minimum": 1,
        "maximum": 1000
      },
      "page_after": {
        "type": "string",
        "description": "Cursor returned by the previous page."
      },
      "page_before": {
        "type": "string",
        "description": "Cursor returned by the next page."
      },
      "page_limit": {
        "type": "integer",
        "description": "Deprecated offset-pagination limit sent as page[limit]. Prefer page_size.",
        "minimum": 1,
        "maximum": 1000
      },
      "page_offset": {
        "type": "integer",
        "description": "Deprecated offset-pagination offset sent as page[offset]. Prefer cursors.",
        "minimum": 0,
        "maximum": 10000
      },
      "count": {
        "type": "boolean",
        "description": "Request Outreach total-count metadata; false is faster for pagination."
      },
      "sort": {
        "type": "string",
        "description": "Comma-separated sortable fields; prefix a field with - for descending order."
      },
      "include": {
        "type": "string",
        "description": "Comma-separated related resources to include."
      },
      "fields": {
        "type": "object",
        "description": "Sparse fieldsets keyed by JSON:API resource type, sent as fields[resource].",
        "properties": {
          "account": {
            "type": "string"
          },
          "accountNote": {
            "type": "string"
          },
          "auditLog": {
            "type": "string"
          },
          "batch": {
            "type": "string"
          },
          "batchItem": {
            "type": "string"
          },
          "call": {
            "type": "string"
          },
          "callDisposition": {
            "type": "string"
          },
          "callPurpose": {
            "type": "string"
          },
          "complianceRequest": {
            "type": "string"
          },
          "contentCategory": {
            "type": "string"
          },
          "contentCategoryMembership": {
            "type": "string"
          },
          "contentCategoryOwnership": {
            "type": "string"
          },
          "customDuty": {
            "type": "string"
          },
          "duty": {
            "type": "string"
          },
          "emailAddress": {
            "type": "string"
          },
          "event": {
            "type": "string"
          },
          "favorite": {
            "type": "string"
          },
          "import": {
            "type": "string"
          },
          "kaiaRecording": {
            "type": "string"
          },
          "kaiaVoiceImport": {
            "type": "string"
          },
          "mailAlias": {
            "type": "string"
          },
          "mailbox": {
            "type": "string"
          },
          "mailing": {
            "type": "string"
          },
          "opportunity": {
            "type": "string"
          },
          "opportunityProspectRole": {
            "type": "string"
          },
          "opportunityStage": {
            "type": "string"
          },
          "orgSetting": {
            "type": "string"
          },
          "persona": {
            "type": "string"
          },
          "phoneNumber": {
            "type": "string"
          },
          "product": {
            "type": "string"
          },
          "profile": {
            "type": "string"
          },
          "prospect": {
            "type": "string"
          },
          "prospectNote": {
            "type": "string"
          },
          "purchase": {
            "type": "string"
          },
          "recipient": {
            "type": "string"
          },
          "role": {
            "type": "string"
          },
          "ruleset": {
            "type": "string"
          },
          "sequence": {
            "type": "string"
          },
          "sequenceState": {
            "type": "string"
          },
          "sequenceStep": {
            "type": "string"
          },
          "sequenceTemplate": {
            "type": "string"
          },
          "snippet": {
            "type": "string"
          },
          "stage": {
            "type": "string"
          },
          "task": {
            "type": "string"
          },
          "taskDisposition": {
            "type": "string"
          },
          "taskPriority": {
            "type": "string"
          },
          "taskPurpose": {
            "type": "string"
          },
          "team": {
            "type": "string"
          },
          "template": {
            "type": "string"
          },
          "user": {
            "type": "string"
          },
          "webhook": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "filters": {
        "type": "object",
        "description": "Endpoint-specific Outreach filters. Relationship attributes use keys such as owner[id].",
        "additionalProperties": false
      }
    },
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.data` | `array` | No | — | — |
| `result.data.data[].attributes` | `object` | No | — | A descriptor of the point in the process, used for categorizing Prospects. |
| `result.data.data[].attributes.color` | `string \| null` | No | — | The color the stage label will be highlighted in the interface, specified as a hexidecimal value (e.g. "#5951ff"). Maximum length: 255. |
| `result.data.data[].attributes.createdAt` | `string \| null` | No | — | The date and time the stage was created. Format: `date-time`. |
| `result.data.data[].attributes.name` | `string \| null` | No | — | The name of the stage (e.g. "Qualified Lead"). Maximum length: 255. |
| `result.data.data[].attributes.order` | `integer \| null` | No | — | The stage's display order within the collection. |
| `result.data.data[].attributes.updatedAt` | `string \| null` | No | — | The date and time the stage was last updated. Format: `date-time`. |
| `result.data.data[].id` | `integer` | No | — | — |
| `result.data.data[].relationships` | `object` | No | — | — |
| `result.data.data[].relationships.creator` | `object` | No | — | The creator of the stage. Relationship creator cannot be used as a filter. |
| `result.data.data[].relationships.creator.data` | `object \| null` | No | — | — |
| `result.data.data[].relationships.creator.data.id` | `integer` | No | — | — |
| `result.data.data[].relationships.creator.data.type` | `"user"` | No | — | Allowed: `user`. |
| `result.data.data[].relationships.creator.links` | `object` | No | — | — |
| `result.data.data[].relationships.creator.links.related` | `string` | No | — | Format: `uri`. |
| `result.data.data[].relationships.prospects` | `object` | No | — | The prospects associated to the stage. You can use only the attribute id to filter stages by prospects (e.g. filter\[prospects]\[id]=X). |
| `result.data.data[].relationships.prospects.links` | `object` | No | — | — |
| `result.data.data[].relationships.prospects.links.related` | `string` | No | — | Format: `uri`. |
| `result.data.data[].relationships.updater` | `object` | No | — | The most recent updater of the stage. Relationship updater cannot be used as a filter. |
| `result.data.data[].relationships.updater.data` | `object \| null` | No | — | — |
| `result.data.data[].relationships.updater.data.id` | `integer` | No | — | — |
| `result.data.data[].relationships.updater.data.type` | `"user"` | No | — | Allowed: `user`. |
| `result.data.data[].relationships.updater.links` | `object` | No | — | — |
| `result.data.data[].relationships.updater.links.related` | `string` | No | — | Format: `uri`. |
| `result.data.data[].type` | `string` | No | — | — |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "description": "Provider response payload.",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "attributes": {
                  "type": "object",
                  "description": "A descriptor of the point in the process, used for categorizing Prospects.",
                  "properties": {
                    "color": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The color the stage label will be highlighted in the interface, specified as a hexidecimal value (e.g. \"#5951ff\").",
                      "maxLength": 255
                    },
                    "createdAt": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The date and time the stage was created.",
                      "format": "date-time"
                    },
                    "name": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The name of the stage (e.g. \"Qualified Lead\").",
                      "maxLength": 255
                    },
                    "order": {
                      "type": [
                        "integer",
                        "null"
                      ],
                      "description": "The stage's display order within the collection."
                    },
                    "updatedAt": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The date and time the stage was last updated.",
                      "format": "date-time"
                    }
                  },
                  "additionalProperties": false
                },
                "id": {
                  "type": "integer"
                },
                "relationships": {
                  "type": "object",
                  "properties": {
                    "creator": {
                      "description": "The creator of the stage. Relationship creator cannot be used as a filter.",
                      "properties": {
                        "data": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "properties": {
                            "id": {
                              "type": "integer"
                            },
                            "type": {
                              "type": "string",
                              "enum": [
                                "user"
                              ]
                            }
                          },
                          "additionalProperties": false
                        },
                        "links": {
                          "type": "object",
                          "properties": {
                            "related": {
                              "type": "string",
                              "format": "uri"
                            }
                          },
                          "additionalProperties": false
                        }
                      },
                      "additionalProperties": false
                    },
                    "prospects": {
                      "description": "The prospects associated to the stage. You can use only the attribute id to filter stages by prospects (e.g. filter[prospects][id]=X).",
                      "properties": {
                        "links": {
                          "type": "object",
                          "properties": {
                            "related": {
                              "type": "string",
                              "format": "uri"
                            }
                          },
                          "additionalProperties": false
                        }
                      },
                      "additionalProperties": false
                    },
                    "updater": {
                      "description": "The most recent updater of the stage. Relationship updater cannot be used as a filter.",
                      "properties": {
                        "data": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "properties": {
                            "id": {
                              "type": "integer"
                            },
                            "type": {
                              "type": "string",
                              "enum": [
                                "user"
                              ]
                            }
                          },
                          "additionalProperties": false
                        },
                        "links": {
                          "type": "object",
                          "properties": {
                            "related": {
                              "type": "string",
                              "format": "uri"
                            }
                          },
                          "additionalProperties": false
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                },
                "type": {
                  "type": "string"
                }
              },
              "additionalProperties": false
            }
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Outreach provider guide](https://deepline.com/docs/providers/outreach/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


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