---
title: "Get a list of pipelines"
method: GET
path: "/stagesets"
tags: ["Stagesets (Pipelines)"]
---

# Get a list of pipelines

`GET /stagesets`

Returns every pipeline in the authenticated user's Nutshell instance, including archived pipelines. Pipelines are also known as stagesets. OAuth access tokens require the read scope. When pipeline visibility is enabled, restricted pipelines are omitted unless the authenticated user is an administrator or the pipeline is shared directly or through a team.

## Response `200`

Pipelines visible to the authenticated user.

- object
  - `meta` Meta, required — Information about the Nutshell instance making the request
    - `instanceId` string — The Nutshell instance ID
    - `siteId` string — Site ID for WebFX customers
  - `links` object, required — Top-level relationship metadata for pipeline stages.
  - `stagesets` object[], required
    - `id` string, required — The API ID of this entity, formatted {integer}-{entityType}
    - `name` string, required — The name of the pipeline
    - `default` boolean, required — Whether this is the default pipeline for new leads.
    - `canAccess` boolean, required — Whether the user can access the stageset based on the current Nutshell plan.
    - `status` integer, required — The status of the stageset. '1' for active, '2' for draft, '3' for retired
    - `type` 'stagesets', required
    - `links` object, required
      - `stages` string[], required

## Other responses

- `401` — Authentication required.
- `403` — The OAuth access token does not include the read scope.

---

[API](https://skmtc.dev/nutshell/apis/nutshell-api.md) · [All operations](https://skmtc.dev/nutshell/apis/nutshell-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nutshell/nutshell-api/revisions/14f59cf6a09a/schema)