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

# Get incoming runs of a route

> Lists the runs of the incoming configuration of a route, newest first, with the task counts limited to the tasks of this route. Each run reports its start and end time, duration, memory usage and the number of finished, filtered and failed tasks. The key of a run identifies it in the run log entries endpoint. Returns a 404 when the route does not exist and an empty result when the incoming configuration has not run yet.



## OpenAPI

````yaml /schema.json get /routes/{identifier}/incoming-logs
openapi: 3.1.0
info:
  version: 01M732K6KS2BC0GCRAAM8D44R5
  title: Alumio API
  description: Access Alumio through OpenAPI v3.1.
servers:
  - url: /api/v1
security: []
paths:
  /routes/{identifier}/incoming-logs:
    get:
      tags:
        - ProcessLogs
      summary: Get incoming runs of a route
      description: >-
        Lists the runs of the incoming configuration of a route, newest first,
        with the task counts limited to the tasks of this route. Each run
        reports its start and end time, duration, memory usage and the number of
        finished, filtered and failed tasks. The key of a run identifies it in
        the run log entries endpoint. Returns a 404 when the route does not
        exist and an empty result when the incoming configuration has not run
        yet.
      operationId: getRouteIncomingLogs
      parameters:
        - name: identifier
          in: path
          description: Route identifier
          required: true
          schema:
            type: string
        - name: from
          in: query
          description: Offset of the first run.
          required: false
          schema:
            type: integer
            default: 0
            minimum: 0
        - name: size
          in: query
          description: Number of runs per page.
          required: false
          schema:
            type: integer
            default: 20
            minimum: 0
            maximum: 100
        - name: filter
          in: query
          description: >-
            JSON encoded search criteria applied to the log entries, for example
            {"where":{"@timestamp":{"gte":"2026-01-01T00:00:00Z"}}}.
          required: false
          schema:
            type: string
        - name: space
          in: query
          description: Space Identifier
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LogRunListResult'
        '404':
          description: The route does not exist
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    LogRunListResult:
      type: object
      properties:
        metadata:
          $ref: '#/components/schemas/ActionMetaData'
        results:
          type: array
          items:
            $ref: '#/components/schemas/LogRun'
    Error:
      type: object
      properties:
        status:
          type: string
        context:
          type: object
        type:
          type: string
        title:
          type: string
        detail:
          type: string
        violations:
          type: array
          items:
            type: object
            properties:
              title:
                type: string
              propertyPath:
                type: string
              type:
                type: string
    ActionMetaData:
      type: object
      properties:
        totalCount:
          type: integer
          format: int32
          description: Total count of items that match the criteria.
    LogRun:
      type: object
      description: >-
        The status of one run, aggregated from its log entries. Filter buckets
        expose the number of matching entries as doc_count; metric buckets
        expose value and value_as_string.
      properties:
        key:
          type: string
          description: Run identifier.
        doc_count:
          type: integer
          description: Number of log entries of the run.
        process_started:
          type: object
          additionalProperties: true
          description: Start of the run, with the earliest timestamp under start.
        process_finished:
          type: object
          additionalProperties: true
          description: >-
            End of the run, with the latest timestamp under end and the duration
            in seconds under duration.
        process_failed:
          type: object
          additionalProperties: true
          description: Entries reporting a failed run.
        process_scheduled:
          type: object
          additionalProperties: true
          description: Entries reporting that the run was scheduled on the queue.
        process_skipped:
          type: object
          additionalProperties: true
          description: Entries reporting that the run was skipped by the queue.
        process_killed:
          type: object
          additionalProperties: true
          description: Entries reporting that the run was killed.
        process_heartbeat:
          type: object
          additionalProperties: true
          description: Timestamp of the most recent entry of the run.
        task_created:
          type: object
          additionalProperties: true
          description: Tasks created by the run.
        task_finished:
          type: object
          additionalProperties: true
          description: Tasks finished by the run.
        task_filtered:
          type: object
          additionalProperties: true
          description: Tasks filtered by the run.
        task_failed:
          type: object
          additionalProperties: true
          description: Tasks failed by the run.
        max_memory_peak_usage:
          type: object
          additionalProperties: true
          description: Highest peak memory usage in bytes reported by the run.
      additionalProperties: true

````

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