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

# List jobs

## Description

The **List Jobs** endpoint returns your async jobs, most useful for monitoring several runs at once or finding a `job_id` you didn't store.

<AccordionGroup>
  <Accordion title="How It Works">
    * **Input:** Optionally filter by `status` and paginate with `skip`.
    * **Processing:** The system returns your jobs with their current state.
    * **Output:** A `jobs` array plus a `total` count. Each job carries the same fields as [Get job status](/v2/jobs/get_job_status).
  </Accordion>

  <Accordion title="Query Parameters">
    | Parameter | Type    | Description                                                                                |
    | :-------- | :------ | :----------------------------------------------------------------------------------------- |
    | `status`  | enum    | Filter by job state: `queued`, `running`, `succeeded`, `failed`, `cancelled`, or `expired` |
    | `skip`    | integer | Number of jobs to skip, for pagination                                                     |
  </Accordion>

  <Accordion title="Best Practices">
    * **Filter by `status=running`** to see what is currently consuming capacity.
    * **Use [Get job status](/v2/jobs/get_job_status)** for polling a single job — this endpoint is for overviews, not tight loops.
  </Accordion>
</AccordionGroup>

<Icon icon="thumbtack" iconType="solid" color="red" /> **See [async jobs](/v2/async-jobs) for the full job lifecycle.**


## OpenAPI

````yaml get /v2/jobs
openapi: 3.1.0
info:
  title: Partner Service
  version: 0.3.18
servers:
  - url: https://api.explorium.ai
    description: AgentSource Server
security: []
paths:
  /v2/jobs:
    get:
      tags:
        - AsyncJobs
      summary: Get Jobs
      operationId: v2_jobs
      parameters:
        - required: false
          schema:
            $ref: '#/components/schemas/PartnerJobStatus'
          name: status
          in: query
        - required: false
          schema:
            type: integer
            minimum: 0
            title: Skip
          name: skip
          in: query
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2JobsResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
        - APIKeyHeader: []
components:
  schemas:
    PartnerJobStatus:
      type: string
      enum:
        - queued
        - running
        - succeeded
        - failed
        - cancelled
        - expired
      title: PartnerJobStatus
      description: An enumeration.
    V2JobsResponse:
      properties:
        jobs:
          items:
            $ref: '#/components/schemas/V2JobListItem'
          type: array
          title: Jobs
        total:
          type: integer
          title: Total
      type: object
      required:
        - jobs
        - total
      title: V2JobsResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    V2JobListItem:
      properties:
        job_id:
          type: string
          title: Job Id
        job_type:
          type: string
          title: Job Type
        endpoint:
          type: string
          title: Endpoint
        status:
          type: string
          title: Status
        created_at:
          type: string
          format: date-time
          title: Created At
        finished_at:
          type: string
          format: date-time
          title: Finished At
      type: object
      required:
        - job_id
        - job_type
        - status
      title: V2JobListItem
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: api_key

````