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

# Get step data

> Returns what one step of an execution actually sent and received, payload bodies included.
This is the only endpoint that returns payload bodies, which is why its page size is capped at
10 rather than 100: every row can require object-storage reads. Values above 10 are reduced to
10; use offset to fetch later pages.
            
A step can produce several entries because it records different payload kinds, or because it
ran more than once due to a loop or retry. Use type, loopPath, runNumber
and retryNo to narrow the result. A loop path narrows to a subtree of iterations - it is
not a unique key and can legitimately match several rows.
            
A payload that could not be read from storage is reported with valueUnavailable or
additionalUnavailable rather than failing the request.



## OpenAPI

````yaml /developers/api-reference/openapi.json get /v1/executions/{executionId}/log/{stepNo}/data
openapi: 3.0.0
info:
  title: Engini API
  version: v1
  description: The Engini public API.
servers:
  - url: https://api.engini.io
security:
  - Bearer: []
  - ApiKey: []
tags:
  - name: Auth
    description: Identify the caller a Developer API request is authenticated as.
  - name: On-prem agents
    description: >-
      Provision and manage agents that run Engini tasks inside a customer's
      network.
  - name: Applications
    description: >-
      Discover the applications (toolkits) available in Engini and their
      connection requirements.
  - name: Tools
    description: Browse and execute the tools exposed by Engini applications.
  - name: Toolsets
    description: Manage toolsets - named groupings of connections and tools.
  - name: McpServers
    description: >-
      Inspect and maintain MCP servers - the account-wide endpoints that expose
      Engini tools and workflows over the Model Context Protocol. Distinct from
      the MCPClient connection kind, which is Engini consuming a third-party MCP
      server.
  - name: Connections
    description: >-
      Manage connections to applications, including OAuth sign-in and
      default-connection selection.
  - name: Folders
    description: >-
      List the folders that organize workflows in each workspace and
      environment.
  - name: Workflows
    description: >-
      List workflows, and build them from a plan: search the catalog, read
      schemas and options, compile, create and update.
  - name: Executions
    description: >-
      Read execution history for workflows, table automations and app business
      rules, including per-step logs and recorded payloads.
  - name: Triggers
    description: >-
      Create triggers that fire when something changes in a connected app, and
      manage the destinations their events are delivered to.
paths:
  /v1/executions/{executionId}/log/{stepNo}/data:
    get:
      tags:
        - Executions
      summary: Get step data
      description: >-
        Returns what one step of an execution actually sent and received,
        payload bodies included.

        This is the only endpoint that returns payload bodies, which is why its
        page size is capped at

        10 rather than 100: every row can require object-storage reads. Values
        above 10 are reduced to

        10; use offset to fetch later pages.
                    
        A step can produce several entries because it records different payload
        kinds, or because it

        ran more than once due to a loop or retry. Use type, loopPath, runNumber

        and retryNo to narrow the result. A loop path narrows to a subtree of
        iterations - it is

        not a unique key and can legitimately match several rows.
                    
        A payload that could not be read from storage is reported with
        valueUnavailable or

        additionalUnavailable rather than failing the request.
      operationId: Executions_ListExecutionData
      parameters:
        - name: executionId
          in: path
          required: true
          description: Identifier of the execution.
          schema:
            type: integer
            format: int32
          x-position: 1
        - name: stepNo
          in: path
          required: true
          description: Step number within the workflow.
          schema:
            type: integer
            format: int32
          x-position: 2
        - name: type
          in: query
          description: 'Optional payload-kind filter: request, response, input or status.'
          schema:
            type: string
            nullable: true
          x-position: 3
        - name: loopPath
          in: query
          style: form
          explode: true
          description: >-
            Optional loop position as step:iteration, repeated once per nesting
            level, outermost first.
          schema:
            type: array
            nullable: true
            items:
              type: string
          x-position: 4
        - name: runNumber
          in: query
          description: Optional filter to one run of the step.
          schema:
            type: integer
            format: int32
            nullable: true
          x-position: 5
        - name: retryNo
          in: query
          description: Optional filter to one retry attempt.
          schema:
            type: integer
            format: int32
            nullable: true
          x-position: 6
        - name: status
          in: query
          description: Optional filter on the step status the payload was recorded at.
          schema:
            type: string
            nullable: true
          x-position: 7
        - name: offset
          in: query
          description: Zero-based index of the first item to return. Defaults to 0.
          schema:
            type: integer
            format: int32
            default: 0
          x-position: 8
        - name: top
          in: query
          description: >-
            Maximum number of items to return. Values above 10 are reduced to
            10. Defaults to 10; use offset to fetch later pages.
          schema:
            type: integer
            format: int32
            default: 10
          x-position: 9
      responses:
        '200':
          description: A paginated list of recorded payloads.
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/PaginatedResponseOfExecutionDataEntryPublicDTO
        '400':
          description: Bad request - malformed body or invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized - missing or invalid bearer token or API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden - the caller lacks access to the resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not found - the resource does not exist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '410':
          description: |2-

                         The execution's per-step detail has passed its workflow's history retention window and has
                         been deleted. The execution itself still exists and is still listed.
                         
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Too many requests - rate limit exceeded.
          headers:
            Retry-After:
              description: Number of seconds to wait before retrying.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error - an unexpected error occurred.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - Bearer: []
        - ApiKey: []
      x-codeSamples:
        - lang: python
          label: Python
          source: |-
            from engini import Engini

            client = Engini()  # reads ENGINI_API_KEY

            # payloads can hold customer data: use a least-privilege key
            entries = client.executions.data(4567, 3, type="response")
        - lang: typescript
          label: TypeScript
          source: >-
            import { Engini } from "@engini/sdk";


            const client = new Engini(); // reads ENGINI_API_KEY


            // payloads can hold customer data: use a least-privilege key

            const entries = await client.executions.data(4567, 3, { type:
            "response" });
        - lang: bash
          label: CLI
          source: engini executions data 4567 3 --type response --json
components:
  schemas:
    PaginatedResponseOfExecutionDataEntryPublicDTO:
      type: object
      description: Offset-based paginated wrapper for a list of items.
      additionalProperties: false
      required:
        - items
        - totalCount
        - offset
        - top
      properties:
        items:
          type: array
          description: The items in the current page.
          items:
            $ref: '#/components/schemas/ExecutionDataEntryPublicDTO'
        totalCount:
          type: integer
          description: Total number of items available across all pages.
          format: int32
        offset:
          type: integer
          description: Number of items skipped before this page (the requested offset).
          format: int32
        top:
          type: integer
          description: Maximum number of items requested for this page.
          format: int32
    ErrorResponse:
      type: object
      description: >-
        Unified machine-readable error envelope returned by every non-200
        Developer API response.
      additionalProperties: false
      required:
        - errorCode
        - message
        - requestId
        - timestamp
      properties:
        errorCode:
          type: string
          description: Machine-readable error code identifying the failure.
        message:
          type: string
          description: Human-readable error message.
        requestId:
          type: string
          description: Identifier of the request, for support/correlation.
        timestamp:
          type: string
          description: Timestamp when the error occurred (ISO 8601).
        details:
          type: array
          description: Per-field validation details, when applicable.
          nullable: true
          items:
            $ref: '#/components/schemas/ErrorDetail'
    ExecutionDataEntryPublicDTO:
      type: object
      description: >-
        One recorded payload of a step within an execution: what the step was
        asked to do, what it sent,

        what came back, or a status marker. A step that ran inside a loop, or
        ran more than once,

        produces several of these.
      additionalProperties: false
      required:
        - type
        - runNumber
        - status
      properties:
        type:
          type: string
          description: 'Kind of payload: request, response, input or status.'
        runNumber:
          type: integer
          description: >-
            Which run of the step this payload belongs to. This is a run marker,
            not an attempt counter -

            a step resuming from a delay can carry a lower run number than an
            earlier payload. Use

            RetryNo for retries.
          format: int32
        retryNo:
          type: integer
          description: >-
            Retry number this payload was recorded on (0 = first attempt);
            omitted when not applicable.
          format: int32
          nullable: true
        status:
          type: string
          description: >-
            Status of the step at the time the payload was recorded. This is a
            step status, not an

            execution status. A status this API version does not publish is
            returned in the escape

            form "unknown:{id}".
        createdAt:
          type: string
          description: When the payload was recorded (UTC); omitted when not recorded.
          format: date-time
          nullable: true
        value:
          description: >-
            The payload itself, whole. Omitted when there is no payload or
            storage could not return it.
          nullable: true
        additional:
          description: >-
            Supplementary payload recorded alongside Value; omitted when there
            is none

            or storage could not return it.
          nullable: true
        valueUnavailable:
          type: boolean
          description: >-
            True when the payload could not be read from storage. The row is
            still returned - a storage

            read failure is not modelled as an HTTP error, because retrying
            against storage that is

            already failing helps nobody.
          nullable: true
        additionalUnavailable:
          type: boolean
          description: True when the supplementary payload could not be read from storage.
          nullable: true
        loopPath:
          type: array
          description: >-
            Where in the workflow's loops this payload was produced, outermost
            loop first. Omitted

            entirely - never an empty array - for a payload that was not
            produced inside a loop.
          nullable: true
          items:
            $ref: '#/components/schemas/LoopPathSegmentPublicDTO'
    ErrorDetail:
      type: object
      description: A single field-level error detail within an ErrorResponse.
      additionalProperties: false
      required:
        - field
        - issue
      properties:
        field:
          type: string
          description: Name of the field the issue relates to.
        issue:
          type: string
          description: Description of the issue with the field.
    LoopPathSegmentPublicDTO:
      type: object
      description: >-
        One segment of a loop path: which loop step, and which iteration of it.
        A nested loop yields one

        segment per level, outermost first.
      additionalProperties: false
      required:
        - step
        - iteration
      properties:
        step:
          type: integer
          description: Step number of the loop step this segment refers to.
          format: int32
        iteration:
          type: integer
          description: Zero-based iteration index of that loop step.
          format: int32
  securitySchemes:
    Bearer:
      type: http
      description: Enter your JWT token
      scheme: bearer
      bearerFormat: JWT
    ApiKey:
      type: apiKey
      description: >-
        Opaque Developer API key (prefix `eng_`). Authenticates as the key's
        owner and resolves the account automatically.
      name: x-api-key
      in: header

````

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