> ## 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.

# Retrieve Job

> Fetches a single job by its ID, including scheduling and request details.



## OpenAPI

````yaml /openapi.json get /jobs/{id}
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/{id}:
    get:
      tags:
        - Jobs
      summary: Retrieve Job
      description: >-
        Fetches a single job by its ID, including scheduling and request
        details.
      operationId: getJobsById
      parameters:
        - name: id
          in: path
          required: true
          schema:
            description: Unique identifier of the job.
            example: 550e8400-e29b-41d4-a716-446655440000
            type: string
      responses:
        '200':
          description: A scheduled HTTP job managed by QuedUp.
          content:
            application/json:
              schema:
                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
        '404':
          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>`.

````