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

# Flow Run Outputs

> Retrieve the outputs/results from a flow run with pagination and filtering options

Retrieve the outputs (results) produced by a flow run.
This endpoint allows you to access the actual data extracted or enriched by the flow, with support for pagination and filtering by step.

**Use Cases**:

* Retrieve results from a completed flow run
* Access data as it's being generated (for long-running flows)
* Filter outputs by specific steps in the workflow
* Paginate through large result sets

**Examples**:

<AccordionGroup>
  <Accordion title="Paginate through large result sets">
    ```bash theme={null}
    # First 100 results
    curl --request GET \
      --url 'https://api.edges.run/v1/flows/runs/550e8400-e29b-41d4-a716-446655440000/outputs?limit=100&offset=0' \
      --header 'X-API-Key: <your-api-key>'

    # Next 100 results
    curl --request GET \
      --url 'https://api.edges.run/v1/flows/runs/550e8400-e29b-41d4-a716-446655440000/outputs?limit=100&offset=100' \
      --header 'X-API-Key: <your-api-key>'
    ```
  </Accordion>

  <Accordion title="Filter outputs by step">
    If you want to retrieve only outputs from a specific step (e.g., only enrichment results):

    ```bash theme={null}
    curl --request GET \
      --url 'https://api.edges.run/v1/flows/runs/550e8400-e29b-41d4-a716-446655440000/outputs?step_uid=660e8400-e29b-41d4-a716-446655440001' \
      --header 'X-API-Key: <your-api-key>'
    ```
  </Accordion>
</AccordionGroup>

<Tip>
  For better performance with large result sets, use webhooks (callback URLs) when creating flow runs. This way, results are automatically sent to your endpoint as they're generated, eliminating the need to poll.
</Tip>


## OpenAPI

````yaml GET /flows/runs/{flow_run_uid}/outputs
openapi: 3.1.0
info:
  title: ED Automation Flows API
  description: This is the Flows API documentation for ED Automation
  version: dev
servers:
  - url: https://api.edges.run/v1
security:
  - XApiKeyAuth: []
paths:
  /flows/runs/{flow_run_uid}/outputs:
    get:
      tags:
        - flows
      summary: Get outputs by Flow Run UUID
      operationId: getFlowRunOutputs
      parameters:
        - schema:
            type: integer
            minimum: 1
            maximum: 500
            default: 100
          in: query
          name: limit
          required: false
          description: Number of flow outputs to return
        - schema:
            type: integer
            minimum: 0
            nullable: true
            default: null
            deprecated: true
          in: query
          name: offset
          required: false
          description: (deprecated) Number of flow outputs to skip for pagination
        - schema:
            type: string
            title: Pagination Cursor
          in: query
          name: cursor
          required: false
          description: >-
            (optional) Cursor value obtained from the `X-Pagination-Next`
            response header of a previous request, used to continue pagination.
            If not provided, the first page will be returned.
        - schema:
            type: string
            format: uuid
          in: path
          name: flow_run_uid
          required: true
          description: Flow Run UUID
      responses:
        '200':
          description: Returns the flow run outputs
          headers:
            X-Pagination-Next:
              schema:
                title: Next Page URL
                type: string
              description: >-
                URL to retrieve the next page of results. If present, indicates
                that there are more results to fetch. This URL includes the
                necessary query parameters (like cursor) to get the next set of
                outputs.
          content:
            application/json:
              schema:
                description: Returns the flow run outputs
                type: array
                items:
                  type: object
                  description: Flow Run Output
                  additionalProperties: true
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/def-0'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/def-0'
components:
  schemas:
    def-0:
      title: APIError
      description: >-
        Represents an error returned by the API. This schema defines the
        standard structure of error messages to ensure consistent error handling
        across the application.
      type: object
      properties:
        error_label:
          type: string
          nullable: true
        error_scope:
          type: string
          enum:
            - input
            - integ
            - param
            - config
          nullable: true
        error_ref:
          type: string
          nullable: true
          example: ERR-12345
        message:
          type: string
        status_code:
          type: integer
          nullable: true
        params:
          type: object
          additionalProperties:
            anyOf:
              - type: string
              - type: number
              - type: boolean
              - type: 'null'
              - type: array
                items:
                  type: string
          nullable: true
        data:
          type: object
          nullable: true
          additionalProperties: true
          description: Additional data about the error
      additionalProperties: false
  securitySchemes:
    XApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````