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

# List Jobs

> Returns jobs using keyset pagination with an opaque cursor.



## OpenAPI

````yaml /openapi.json get /jobs
openapi: 3.0.3
info:
  title: QuedUp API
  description: Development documentation
  version: 0.1.0
servers:
  - url: https://api.quedup.dev
    description: Production API
security: []
tags:
  - name: Jobs
    description: Job management endpoints.
paths:
  /jobs:
    get:
      tags:
        - Jobs
      summary: List Jobs
      description: Returns jobs using keyset pagination with an opaque cursor.
      operationId: getJobs
      parameters:
        - name: cursor
          in: query
          required: false
          schema:
            description: Opaque pagination cursor returned from a previous list response.
            example: >-
              eyJjcmVhdGVkX2F0IjoiMjAyNi0wMy0wOVQwMDowMDowMC4wMDBaIiwiaWQiOiI1NTBlODQwMC1lMjliLTQxZDQtYTcxNi00NDY2NTU0NDAwMDAifQ
            type: string
      responses:
        '200':
          description: Paginated list of jobs.
          content:
            application/json:
              schema:
                example:
                  data:
                    - id: 550e8400-e29b-41d4-a716-446655440000
                      name: Nightly customer sync
                      url: https://api.example.com/webhooks/customer-sync
                      method: POST
                      headers:
                        Authorization: Bearer sk_test_123
                        Content-Type: application/json
                      body: '{"source":"quedup","action":"sync"}'
                      schedule: 0 0 * * *
                      next_run_at: '2026-03-09T00:00:00.000Z'
                      status: active
                  has_more: false
                  next_cursor: null
                type: object
                required:
                  - data
                  - has_more
                  - next_cursor
                properties:
                  data:
                    description: Jobs returned for the current page.
                    example:
                      - id: 550e8400-e29b-41d4-a716-446655440000
                        name: Nightly customer sync
                        url: https://api.example.com/webhooks/customer-sync
                        method: POST
                        headers:
                          Authorization: Bearer sk_test_123
                          Content-Type: application/json
                        body: '{"source":"quedup","action":"sync"}'
                        schedule: 0 0 * * *
                        next_run_at: '2026-03-09T00:00:00.000Z'
                        status: active
                    type: array
                    items:
                      description: A scheduled HTTP job managed by QuedUp.
                      example:
                        id: 550e8400-e29b-41d4-a716-446655440000
                        name: Nightly customer sync
                        url: https://api.example.com/webhooks/customer-sync
                        method: POST
                        headers:
                          Authorization: Bearer sk_test_123
                          Content-Type: application/json
                        body: '{"source":"quedup","action":"sync"}'
                        schedule: 0 0 * * *
                        next_run_at: '2026-03-09T00:00:00.000Z'
                        status: active
                      type: object
                      required:
                        - id
                        - name
                        - url
                        - method
                        - headers
                        - body
                        - schedule
                        - next_run_at
                        - status
                      properties:
                        id:
                          description: Unique identifier for the job.
                          example: 550e8400-e29b-41d4-a716-446655440000
                          type: string
                        name:
                          description: Human-readable name for the job.
                          example: Nightly customer sync
                          type: string
                        url:
                          description: Destination URL that QuedUp calls when the job runs.
                          format: uri
                          example: https://api.example.com/webhooks/customer-sync
                          type: string
                        method:
                          type: string
                          enum:
                            - GET
                            - POST
                            - PUT
                            - PATCH
                            - DELETE
                          description: >-
                            HTTP method used when QuedUp executes the job
                            request.
                          example: POST
                        headers:
                          description: >-
                            HTTP headers that will be sent with the outbound
                            request.
                          example:
                            Authorization: Bearer sk_test_123
                            Content-Type: application/json
                          type: object
                          additionalProperties: {}
                        body:
                          description: Raw request body sent when the job executes.
                          example: '{"source":"quedup","action":"sync"}'
                          type: string
                        schedule:
                          nullable: true
                          description: >-
                            Cron expression for recurring execution. Null for
                            one-time jobs.
                          example: 0 0 * * *
                          type: string
                        next_run_at:
                          nullable: true
                          description: Next scheduled execution time in ISO 8601 format.
                          format: date-time
                          example: '2026-03-09T00:00:00.000Z'
                          type: string
                        status:
                          type: string
                          enum:
                            - active
                            - paused
                            - failed
                            - completed
                            - running
                          description: Current lifecycle state of the job.
                          example: active
                  has_more:
                    description: Whether another page of results is available.
                    example: false
                    type: boolean
                  next_cursor:
                    nullable: true
                    description: Opaque cursor to request the next page of results.
                    example: >-
                      eyJjcmVhdGVkX2F0IjoiMjAyNi0wMy0wOVQwMDowMDowMC4wMDBaIiwiaWQiOiI1NTBlODQwMC1lMjliLTQxZDQtYTcxNi00NDY2NTU0NDAwMDAifQ
                    type: string
        '400':
          description: Standard error payload returned when a request cannot be completed.
          content:
            application/json:
              schema:
                example:
                  error: invalid_request
                  message: url must be a valid http(s) URL
                  field: url
                type: object
                required:
                  - error
                  - message
                properties:
                  error:
                    description: Stable machine-readable error code.
                    example: invalid_request
                    type: string
                  message:
                    description: Human-readable explanation of the error.
                    example: url must be a valid http(s) URL
                    type: string
                  field:
                    description: >-
                      Request field associated with the validation error, when
                      applicable.
                    example: url
                    type: string
        '500':
          description: Standard error payload returned when a request cannot be completed.
          content:
            application/json:
              schema:
                example:
                  error: invalid_request
                  message: url must be a valid http(s) URL
                  field: url
                type: object
                required:
                  - error
                  - message
                properties:
                  error:
                    description: Stable machine-readable error code.
                    example: invalid_request
                    type: string
                  message:
                    description: Human-readable explanation of the error.
                    example: url must be a valid http(s) URL
                    type: string
                  field:
                    description: >-
                      Request field associated with the validation error, when
                      applicable.
                    example: url
                    type: string
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API key
      description: >-
        Provide your QuedUp API key in the Authorization header as `Bearer
        <api_key>`.

````