List Jobs

curl --request GET \
  --url https://api.example.com/jobs

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Job Management

List Jobs

List and filter jobs for your organization.

Returns a paginated list of molecular simulation jobs with comprehensive filtering options. Use this endpoint to track job progress, retrieve results, and manage your computational workloads.

Common Use Cases:

Monitor job status and progress
Filter jobs by algorithm type or batch
Paginate through large job lists
Find specific jobs by name or user

Job Statuses:

QUEUED: Job accepted and waiting for resources
RUNNING: Job currently executing
COMPLETED: Job finished successfully
FAILED: Job encountered an error

Response includes:

Job metadata and current status
Algorithm type and version
Execution timestamps and metrics
Pagination information for large result sets

GET

jobs

List Jobs

curl --request GET \
  --url https://api.example.com/jobs

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Query Parameters

jobName

string | null

Filter by specific job name

limit

integer

default:50

Maximum number of jobs to return

Required range: 1 <= x <= 100

startKey

string | null

Pagination cursor for next page

batch

string | null

Filter by batch ID

organization

boolean

default:false

Return all jobs in organization

includeSubjobs

boolean

default:false

Include subjob details

jobEmail

string | null

Filter by user email

algorithm

string | null

Filter by algorithm type (e.g., 'boltz', 'rfdiffusion')

Response

Successful Response

Submit Job Get Job Results