> ## Documentation Index > Fetch the complete documentation index at: https://docs.dialtu.com/llms.txt > Use this file to discover all available pages before exploring further. # List pipelines > List the pipelines visible to this API key, newest first. Deleted pipelines are excluded. Use the `id` with *List API input nodes of a pipeline* and *List stages in a pipeline*. ## OpenAPI ````yaml GET /api/v2/public/salesflow/pipelines openapi: 3.1.0 info: title: Dialtu Public API version: '2.0' description: >- Programmatic access to your Dialtu account: schedule AI voice calls, create contacts, push leads into Salesflow pipelines, book calendar appointments and read WhatsApp conversation history. Every request is authenticated with an API key created in the dashboard under **Settings → API Keys**, sent as `Authorization: Bearer pk_...`. servers: - url: https://api.dialtu.com description: Production - url: https://api.stg.dialtu.com description: Staging security: - ApiKeyBearer: [] tags: - name: Calls description: Schedule outbound AI voice calls. - name: Clients description: Create contacts in your account. - name: Salesflow description: Push leads into a pipeline through an API input node. - name: Salesflow pipelines description: Read a pipeline's stages and add, move or remove clients. - name: Calendar description: Check bookable capacity, book appointments and manage waiting lists. - name: WhatsApp description: Read-only conversation history and transcripts. paths: /api/v2/public/salesflow/pipelines: get: tags: - Salesflow pipelines summary: List pipelines description: |- List the pipelines visible to this API key, newest first. Deleted pipelines are excluded. Use the `id` with *List API input nodes of a pipeline* and *List stages in a pipeline*. operationId: listPipelines parameters: - in: query name: status schema: anyOf: - type: string - type: 'null' description: >- Only pipelines in this status: `draft`, `active`, `paused` or `archived`. title: Status required: false description: >- Only pipelines in this status: `draft`, `active`, `paused` or `archived`. - in: query name: limit schema: default: 20 description: Page size (1–100). maximum: 100 minimum: 1 title: Limit type: integer required: false description: Page size (1–100). - in: query name: offset schema: default: 0 description: Number of pipelines to skip. minimum: 0 title: Offset type: integer required: false description: Number of pipelines to skip. responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PublicPipelineListResponse' '401': description: Missing, malformed or revoked API key. content: application/json: schema: $ref: '#/components/schemas/DetailErrorResponse' examples: missing_header: summary: No Authorization header value: detail: Unauthorized invalid_key: summary: Unknown or revoked key value: detail: Invalid or expired API key. Please check your credentials. '422': description: The request did not match the documented schema. content: application/json: schema: $ref: '#/components/schemas/RequestValidationError' example: detail: - type: missing loc: - body - payload - phone_number msg: Field required '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/PublicPipelineErrorResponse' security: - ApiKeyBearer: [] components: schemas: PublicPipelineListResponse: description: Paginated pipeline list. properties: status: const: success default: success description: Response status title: Status type: string data: description: Pipelines on this page items: $ref: '#/components/schemas/PublicPipelineSchema' title: Data type: array count: default: 0 description: Total pipelines matching the filter title: Count type: integer limit: default: 20 description: Page size that was applied title: Limit type: integer offset: default: 0 description: Offset that was applied title: Offset type: integer title: PublicPipelineListResponse type: object DetailErrorResponse: description: 'Plain error body: `{"detail": "..."}`. No `error_code` is included.' properties: detail: description: Human-readable reason for the failure. title: Detail type: string required: - detail title: DetailErrorResponse type: object RequestValidationError: title: RequestValidationError type: object description: >- Returned when the request body, query string or path could not be parsed against the documented schema. Fix the listed fields and retry. properties: detail: type: array title: Detail description: One entry per invalid field. items: $ref: '#/components/schemas/RequestValidationErrorItem' required: - detail PublicPipelineErrorResponse: description: Error response for pipeline operations. properties: status: const: error description: Error status title: Status type: string error_code: description: Machine-readable error code title: Error Code type: string message: description: Human-readable error message title: Message type: string required: - status - error_code - message title: PublicPipelineErrorResponse type: object PublicPipelineSchema: description: A pipeline as listed for integrators. properties: id: description: Pipeline ID, used in the other pipeline endpoints title: Id type: integer name: description: Pipeline name as shown in the Salesflow editor title: Name type: string description: anyOf: - type: string - type: 'null' description: Pipeline description, if any title: Description status: description: '`draft`, `active`, `paused` or `archived`' title: Status type: string stage_count: default: 0 description: Number of stages in the pipeline title: Stage Count type: integer client_count: default: 0 description: Clients currently active on the pipeline title: Client Count type: integer created_at: description: When the pipeline was created (ISO 8601) format: date-time title: Created At type: string required: - id - name - status - created_at title: PublicPipelineSchema type: object RequestValidationErrorItem: title: RequestValidationErrorItem type: object properties: loc: type: array title: Loc description: >- Where the problem is: the first element is `body`, `query` or `path`, followed by the field path. items: anyOf: - type: string - type: integer msg: type: string title: Msg description: What is wrong with the value. type: type: string title: Type description: >- Machine-readable validation error type, e.g. `missing` or `int_parsing`. required: - loc - msg - type securitySchemes: ApiKeyBearer: type: http scheme: bearer bearerFormat: pk_... description: >- API key created in the dashboard under **Settings → API Keys**. Send it as `Authorization: Bearer pk_...`. ````