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

# List jobs



## OpenAPI

````yaml https://api.blon.ai/v1/openapi.json get /jobs
openapi: 3.1.0
info:
  title: Blon API
  version: v1
servers:
  - url: https://api.blon.ai/v1
security: []
paths:
  /jobs:
    get:
      summary: List jobs
      operationId: listJobs
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            default: 20
            type: integer
            minimum: 1
            maximum: 100
        - name: status
          in: query
          required: false
          schema:
            type: string
            enum:
              - queued
              - processing
              - completed
              - failed
              - canceled
        - name: model
          in: query
          required: false
          schema:
            type: string
            minLength: 1
        - name: starting_after
          in: query
          required: false
          schema:
            type: string
            minLength: 1
        - name: created_after
          in: query
          required: false
          schema:
            type: string
            format: date-time
            pattern: >-
              ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
        - name: created_before
          in: query
          required: false
          schema:
            type: string
            format: date-time
            pattern: >-
              ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
        - name: workspace_id
          in: query
          required: false
          schema:
            type: string
            minLength: 1
      responses:
        '200':
          description: Newest first; jobs in a list carry no artifacts.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobList'
        '400':
          description: '`bad_request`, `invalid_input`, `unknown_parameter`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '401':
          description: '`unauthorized`, `session_not_accepted`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '402':
          description: '`insufficient_credits`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '403':
          description: >-
            `forbidden`, `spending_disabled`, `monthly_cap_exceeded`,
            `api_key_spend_limit_exceeded`, `insufficient_scope`,
            `plan_required`
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '404':
          description: '`not_found`, `model_not_found`, `workspace_not_found`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '408':
          description: '`request_timeout` (retryable)'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '409':
          description: >-
            `conflict`, `idempotency_conflict`, `model_price_unavailable`,
            `job_not_cancelable`
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '412':
          description: '`precondition_failed`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '413':
          description: '`payload_too_large`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '415':
          description: '`unsupported_media_type`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '422':
          description: '`input_media_unreadable`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '429':
          description: >-
            `queue_full` (retryable), `concurrency_limit` (retryable),
            `rate_limited` (retryable)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '500':
          description: '`internal_error` (retryable)'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '501':
          description: '`not_implemented`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '502':
          description: '`provider_submission_failed`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '503':
          description: >-
            `provider_capacity_exceeded` (retryable), `provider_unavailable`
            (retryable), `model_disabled` (retryable), `service_unavailable`
            (retryable)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
      security:
        - bearer: []
        - apiKey: []
components:
  schemas:
    JobList:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/Job'
        next_cursor:
          type:
            - string
            - 'null'
        has_more:
          type: boolean
      required:
        - data
        - next_cursor
        - has_more
    ApiError:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - bad_request
                - invalid_input
                - unknown_parameter
                - unauthorized
                - session_not_accepted
                - insufficient_credits
                - forbidden
                - spending_disabled
                - monthly_cap_exceeded
                - api_key_spend_limit_exceeded
                - insufficient_scope
                - plan_required
                - not_found
                - model_not_found
                - workspace_not_found
                - request_timeout
                - conflict
                - idempotency_conflict
                - model_price_unavailable
                - job_not_cancelable
                - precondition_failed
                - payload_too_large
                - unsupported_media_type
                - input_media_unreadable
                - queue_full
                - concurrency_limit
                - rate_limited
                - internal_error
                - not_implemented
                - provider_submission_failed
                - provider_capacity_exceeded
                - provider_unavailable
                - model_disabled
                - service_unavailable
            message:
              type: string
            request_id:
              type: string
            retryable:
              type: boolean
            retry_after_seconds:
              type:
                - number
                - 'null'
            details: {}
          required:
            - code
            - message
            - request_id
            - retryable
            - retry_after_seconds
            - details
      required:
        - error
    Job:
      type: object
      properties:
        id:
          type: string
        object:
          type: string
          const: job
        model:
          type: string
        status:
          type: string
          enum:
            - queued
            - processing
            - completed
            - failed
            - canceled
        provider_status:
          description: The upstream provider's own status, verbatim.
          type:
            - string
            - 'null'
        queue_position:
          type:
            - number
            - 'null'
        cancelable:
          type: boolean
        next_poll_after_seconds:
          type:
            - number
            - 'null'
        urls:
          type: object
          properties:
            get:
              type: string
            cancel:
              type:
                - string
                - 'null'
          required:
            - get
            - cancel
        input:
          type: object
          propertyNames:
            type: string
          additionalProperties: {}
        metadata:
          anyOf:
            - type: object
              propertyNames:
                type: string
              additionalProperties: {}
            - type: 'null'
        cost:
          type: object
          properties:
            currency:
              type: string
              enum:
                - CREDITS
                - USD
            estimated:
              type: string
            charged:
              type:
                - string
                - 'null'
            refunded:
              type: string
          required:
            - currency
            - estimated
            - charged
            - refunded
        usage:
          anyOf:
            - type: array
              items:
                type: object
                properties:
                  meter:
                    type: string
                    enum:
                      - output_seconds
                      - input_seconds
                      - output_images
                      - input_items
                      - input_chars_per_1000
                      - per_invocation
                      - input_tokens_per_1m
                      - output_tokens_per_1m
                      - sandbox_runtime_seconds
                      - container_seconds
                  units:
                    type: number
                required:
                  - meter
                  - units
            - type: 'null'
        artifacts:
          anyOf:
            - type: array
              items:
                $ref: '#/components/schemas/Artifact'
            - type: 'null'
        expires_at:
          type:
            - string
            - 'null'
        error:
          anyOf:
            - type: object
              properties:
                code:
                  type: string
                  enum:
                    - content_policy
                    - invalid_input
                    - rate_limited
                    - provider_unavailable
                    - timeout
                    - unknown
                message:
                  type: string
                retryable:
                  type: boolean
              required:
                - code
                - message
                - retryable
            - type: 'null'
        webhook:
          anyOf:
            - type: object
              properties:
                url:
                  type: string
                status:
                  type: string
                  enum:
                    - pending
                    - delivered
                    - failed
                attempts:
                  type: number
              required:
                - url
                - status
                - attempts
            - type: 'null'
        idempotency_hit:
          type: boolean
        request_id:
          type: string
        created_at:
          type: string
        started_at:
          type:
            - string
            - 'null'
        completed_at:
          type:
            - string
            - 'null'
        updated_at:
          type: string
      required:
        - id
        - object
        - model
        - status
        - provider_status
        - queue_position
        - cancelable
        - next_poll_after_seconds
        - urls
        - input
        - metadata
        - cost
        - usage
        - artifacts
        - expires_at
        - error
        - webhook
        - idempotency_hit
        - request_id
        - created_at
        - started_at
        - completed_at
        - updated_at
    Artifact:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        type:
          type: string
          description: image, video or audio
        url:
          type: string
          description: Read URL; signed for 15 minutes unless the asset is public.
        url_expires_at:
          type:
            - string
            - 'null'
        content_type:
          type: string
        size_bytes:
          type:
            - number
            - 'null'
        width:
          type:
            - number
            - 'null'
        height:
          type:
            - number
            - 'null'
        duration_ms:
          type:
            - number
            - 'null'
      required:
        - id
        - name
        - type
        - url
        - url_expires_at
        - content_type
        - size_bytes
        - width
        - height
        - duration_ms
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````

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