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

# List jobs

<Panel>
  <Note>
    Cost: **free**
  </Note>
</Panel>

Retrieves a list of all active jobs for the authenticated user, including job limits and current status information.

This endpoint provides:

* **job limits**: current, remaining, and maximum allowed concurrent jobs,
* **active jobs**: list of all jobs with their current status and input parameters,
* **job management**: overview of your job queue and capacity.

**This endpoint does not affect credits, but rate limits apply.**

### Response structure

The response includes:

* `limits`: your job quota information (current/remaining/max concurrent jobs),
* `active`: array of active jobs with their ID, status, and cleaned input parameters.

<Warning>
  This endpoint returns **only active jobs** (with status `pending` or `processing`). Jobs with status `failed` or `completed` are not included in the response. To check status for specific job, use [`/jobs/{jobId}`](/api-reference/jobs/status) endpoint.
</Warning>

### Use cases

* **Monitor job queue**: check how many jobs are currently active,
* **Job management**: see which jobs are pending, processing, or completed,
* **Capacity planning**: understand your remaining job slots before creating new jobs.


## OpenAPI

````yaml api-reference/openapi-0.yaml get /jobs
openapi: 3.1.0
info:
  title: Workfloows API
  version: '0'
  description: >
    ## Introduction


    This API provides a growing collection of powerful tools and endpoints 

    commonly used in automation workflows. It's designed for individual
    automators, 

    agencies, and app builders who want to streamline processes and connect
    systems.


    ## Authentication


    All requests require an API key, which must be included in the `x-api-key`
    header.


    ```

    x-api-key: <your_api_key>

    ```


    If the API key is missing or invalid, a `401 Unauthorized` response will be
    returned.
servers:
  - url: https://api.workfloo.ws/v0
security: []
paths:
  /jobs:
    get:
      tags:
        - Jobs
      summary: List user jobs
      operationId: listJobs
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  response:
                    type: object
                    properties:
                      success:
                        type: boolean
                        description: Whether the request was successful
                      jobs:
                        type: object
                        properties:
                          limits:
                            type: object
                            properties:
                              current:
                                type: number
                                description: Current number of active jobs
                              remaining:
                                type: number
                                description: Remaining job slots available
                              max:
                                type: number
                                description: Maximum allowed active jobs
                          active:
                            type: array
                            description: List of active jobs
                            items:
                              type: object
                              properties:
                                id:
                                  type: string
                                  description: Job identifier
                                status:
                                  type: string
                                  enum:
                                    - pending
                                    - processing
                                    - completed
                                    - failed
                                  description: Current job status
                                input:
                                  type: object
                                  description: Job input parameters (cleaned)
              examples:
                success:
                  summary: Success
                  value:
                    response:
                      success: true
                      jobs:
                        limits:
                          current: 2
                          remaining: 8
                          max: 10
                        active:
                          - id: 550e8400-e29b-41d4-a716-446655440000
                            status: processing
                            input:
                              url: https://workfloows.com
                              language: en
                          - id: 6ba7b810-9dad-11d1-80b4-00c04fd430c8
                            status: completed
                            input:
                              url: https://example.com
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
        - apiKeyAuth: []
components:
  responses:
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
          examples:
            unauthorized:
              summary: Unauthorized
              value:
                error: Unauthorized.
            apiKeyRequired:
              summary: API Key required
              value:
                error: Unauthorized. API key is required.
    Forbidden:
      description: Forbidden
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
          examples:
            invalidApiKey:
              summary: Invalid API key
              value:
                error: Invalid API key.
            apiKeyNotFound:
              summary: API Key not found
              value:
                error: API Key not found.
            rateLimitExceeded:
              summary: Rate limit exceeded
              value:
                error: Rate limit exceeded.
    InternalServerError:
      description: Internal Server Error
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: An error occurred while processing your request.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````