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

# List Jobs

> List all jobs with optional filtering and pagination.

Lists monitoring and digest jobs for the current user, with optional filtering and pagination.

Use this endpoint as your entry point for dashboards, health checks, and cleanup workflows.

## Common Uses

* Build a job table with status and age.
* Discover active jobs before restarting workers.
* Filter jobs by type or status before follow-up actions.

## Workflow

1. Call `GET /jobs` to list candidate jobs.
2. Open one with [Get Job Details](/api-reference/jobs-get).
3. Stop long-running jobs with [Cancel Job](/api-reference/jobs-delete) when needed.

## Related

* Lifecycle overview: [Job Lifecycle](/core-concepts/job-lifecycle)
* Troubleshooting: [Debugging Playbook](/guides/debugging)


## OpenAPI

````yaml GET /jobs
openapi: 3.1.0
info:
  title: Trio API
  description: Reality as an API - Monitor YouTube Live streams with vision models
  version: 1.0.0
servers:
  - url: https://trio.machinefi.com/api
security: []
paths:
  /jobs:
    get:
      tags:
        - Jobs
      summary: List Jobs
      description: List all jobs with optional filtering and pagination.
      operationId: list_jobs_jobs_get
      parameters:
        - name: status
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Status
        - name: type
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Type
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 20
            title: Limit
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            default: 0
            title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobListResponse'
        '400':
          description: Invalid request or malformed headers
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
            text/plain:
              example: Invalid HTTP request received.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    JobListResponse:
      properties:
        jobs:
          items:
            $ref: '#/components/schemas/JobResponse'
          type: array
          title: Jobs
        total:
          type: integer
          title: Total
        limit:
          type: integer
          title: Limit
        offset:
          type: integer
          title: Offset
      type: object
      required:
        - jobs
        - total
        - limit
        - offset
      title: JobListResponse
      description: Paginated response for job listing.
    ErrorResponse:
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetail'
      type: object
      required:
        - error
      title: ErrorResponse
      description: Wrapper for error responses.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    JobResponse:
      properties:
        job_id:
          type: string
          format: uuid
          title: Job Id
        status:
          $ref: '#/components/schemas/JobStatus'
        created_at:
          type: string
          title: Created At
        stream_url:
          type: string
          title: Stream Url
        job_type:
          type: string
          title: Job Type
        details:
          additionalProperties: true
          type: object
          title: Details
          default: {}
        message:
          anyOf:
            - type: string
            - type: 'null'
          title: Message
      type: object
      required:
        - job_id
        - status
        - created_at
        - stream_url
        - job_type
      title: JobResponse
      description: Response containing job information.
    ErrorDetail:
      properties:
        code:
          type: string
          title: Code
        message:
          type: string
          title: Message
        remediation:
          type: string
          title: Remediation
      type: object
      required:
        - code
        - message
        - remediation
      title: ErrorDetail
      description: Standardized error response for better DX.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    JobStatus:
      type: string
      enum:
        - pending
        - running
        - stopped
        - completed
        - failed
      title: JobStatus
      description: Job status enum.
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````