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

# List pipelines

> Returns the caller's pipelines as runtime metadata summaries, newest first. The response carries a `pagination` block. Page until `data` is short or empty rather than relying on a total count.



## OpenAPI

````yaml /cdc-openapi.yaml get /pipelines
openapi: 3.0.3
info:
  title: Integrate.io ELT & CDC REST API
  description: >
    The Integrate.io ELT & CDC REST API lets you list, create, update, start,
    stop, and archive

    ELT & CDC pipelines from outside the dashboard. Pipelines are described by a
    declarative

    definition document (YAML or JSON), so the same configuration can be
    version-controlled,

    reviewed, and reapplied across environments.


    ## Authentication

    Requests are authenticated with a bearer API key:

    ```

    Authorization: Bearer fdk_<your-key>

    ```

    Every Integrate.io API key is prefixed with `fdk_`. The full key value is
    shown only once at

    creation time. Store it in a secret manager. If a key is lost or leaked,
    revoke it and mint a

    new one. Keys are minted from the dashboard under **Settings > API Keys** by
    account admins.


    ## Pipeline definition document

    Create, replace, and validate requests take a declarative definition
    document. For the full

    schema, supported transformation types, and examples, see the

    [REST API overview](/cdc/api#pipeline-definition-document).
  version: '1.0'
  contact:
    name: Integrate.io Support
    url: https://www.integrate.io
servers:
  - url: https://{host}/api/public/v1
    variables:
      host:
        default: console.flydata.app
        description: >-
          API host. Confirm with the Integrate.io team; the API may instead be
          served from a dedicated host such as api.flydata.app. The public API
          lives under the /api/public/v1 base path.
security:
  - bearerAuth: []
tags:
  - name: Pipelines
    description: Manage ELT & CDC pipelines and their definitions.
paths:
  /pipelines:
    get:
      tags:
        - Pipelines
      summary: List pipelines
      description: >-
        Returns the caller's pipelines as runtime metadata summaries, newest
        first. The response carries a `pagination` block. Page until `data` is
        short or empty rather than relying on a total count.
      operationId: listPipelines
      parameters:
        - name: page
          in: query
          schema:
            type: integer
            default: 1
        - name: page_size
          in: query
          description: Defaults to 50, capped at 100.
          schema:
            type: integer
            default: 50
            maximum: 100
      responses:
        '200':
          description: A page of pipeline metadata.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/PipelineMetadata'
                  pagination:
                    $ref: '#/components/schemas/Pagination'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    PipelineMetadata:
      type: object
      description: >-
        Runtime metadata for a pipeline. Exact fields are subject to
        confirmation with the Integrate.io team.
      properties:
        id:
          type: integer
        name:
          type: string
        status:
          type: string
      additionalProperties: true
    Pagination:
      type: object
      properties:
        page:
          type: integer
        page_size:
          type: integer
    Error:
      type: object
      properties:
        error:
          type: string
      additionalProperties: true
  responses:
    Unauthorized:
      description: Missing or invalid API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Bearer API key, prefixed with fdk_.

````