> ## Documentation Index > Fetch the complete documentation index at: https://runcrate.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # List jobs > Jobs in the caller's workspace and environment, newest first. ## OpenAPI ````yaml /api-reference/openapi.json get /jobs openapi: 3.1.0 info: title: Runcrate API version: 1.0.0 summary: OpenAI-compatible inference API + GPU infrastructure API. description: >- Runcrate exposes two API surfaces. The inference API at `https://api.runcrate.ai/v1` is OpenAI-compatible: it accepts the standard OpenAI SDK with the base URL changed. The infrastructure API at `https://www.runcrate.ai/api/v1` manages GPU instances, jobs, persistent volumes, environments, SSH keys, templates, and billing. Both share a single `rc_live_*` API key. Pricing is per-token, per-image, per-second, or per-minute on the inference API (varies by model; see https://www.runcrate.ai/api/models/catalog for live rates) and per-second on GPU rentals (see https://www.runcrate.ai/pricing for hourly rates per GPU class). All infrastructure API responses are wrapped in `{ "data": ... }`. List responses also include a `meta` object with pagination cursors. Error responses use `{ "error": { "code": "...", "message": "..." } }`. termsOfService: https://www.runcrate.ai/terms contact: name: Runcrate url: https://www.runcrate.ai/contact license: name: Proprietary url: https://www.runcrate.ai/terms servers: - url: https://api.runcrate.ai/v1 description: Inference API (OpenAI-compatible) - url: https://www.runcrate.ai/api/v1 description: >- Infrastructure API (instances, jobs, storage, environments, ssh-keys, templates, billing) security: - ApiKeyAuth: [] tags: - name: Chat description: OpenAI-compatible chat completions. - name: Images description: Text-to-image generation. - name: Videos description: Async text-to-video and image-to-video generation. - name: Audio description: Text-to-speech and speech-to-text. - name: Embeddings description: Vector embeddings for RAG and search. - name: Models description: Model catalog discovery. - name: Instances description: GPU instance lifecycle. - name: Jobs description: >- Run one command on its own GPU machine. The machine stops, and billing ends, when the command exits. - name: Schedules description: >- Start an instance or a job later: once at a set time, or on a repeating cron schedule in your timezone. - name: Storage description: Persistent volume management. - name: Environments description: Resource isolation containers within a workspace. - name: Secrets description: >- Names of the secrets an environment's machines get. Values are set in the dashboard and never returned. - name: SSH Keys description: SSH key management for instance access. - name: Templates description: Pre-built instance images and configurations. - name: Billing description: Credit balance, transactions, usage metrics. paths: /jobs: servers: - url: https://www.runcrate.ai/api/v1 get: tags: - Jobs summary: List jobs description: Jobs in the caller's workspace and environment, newest first. operationId: listJobs parameters: - name: status in: query required: false schema: type: string description: Comma-separated statuses, e.g. `running,queued`. - name: limit in: query required: false schema: type: integer minimum: 1 maximum: 100 default: 20 - name: cursor in: query required: false schema: type: string description: Opaque cursor from `meta.cursor` of the previous page. responses: '200': description: Job list. content: application/json: schema: type: object required: - data properties: data: type: array items: $ref: '#/components/schemas/Job' meta: $ref: '#/components/schemas/ListMeta' '401': $ref: '#/components/responses/Unauthorized' components: schemas: Job: type: object required: - id - name - status - command - gpu_type - gpu_count - max_runtime_minutes - env_keys - created_at description: >- One command run on its own fresh GPU machine. The machine stops, and billing ends, as soon as the command exits, hits `max_runtime_minutes` or is cancelled. properties: id: type: string format: uuid name: type: string description: Defaults to `job-`. status: type: string enum: - queued - starting - running - succeeded - failed - cancelled - timed_out description: >- `queued`: accepted, machine being requested. `starting`: machine launching, setup running. `running`: command started (`started_at` set). Terminal states never change: `succeeded` (exit 0), `failed` (non-zero exit with `exit_code` set, or the machine failed or was stopped with `exit_code` null and `error` saying why), `cancelled` (cancelled through the API, CLI or MCP, or the machine was stopped from Instances), `timed_out` (hit `max_runtime_minutes`, counted from `started_at`). command: type: string description: Run with bash in `/workspace`. gpu_type: type: string description: GPU model (e.g. `A4000`, `H100`). gpu_count: type: integer minimum: 1 maximum: 8 template: type: string nullable: true description: OS template the machine boots from. image: type: string nullable: true description: Container image the command runs in, if set. env_keys: type: array items: type: string description: >- Names of the environment variables passed in `env`. Values are stored only encrypted and never returned. storage_id: type: string nullable: true description: >- Volume mounted at `/workspace`. Files written there are saved back to it when the machine stops. max_runtime_minutes: type: integer minimum: 1 maximum: 1440 exit_code: type: integer nullable: true description: The command's exit code once it has exited. error: type: string nullable: true description: >- Why the job failed when the command did not exit on its own (e.g. budget reached, balance ran out, machine failed to start). instance_id: type: string nullable: true description: >- The machine running the job. It also shows in `GET /instances` while it runs. environment_id: type: string created_at: type: string format: date-time started_at: type: string format: date-time nullable: true description: When the command started. ended_at: type: string format: date-time nullable: true description: Set on every terminal status. cost_per_hour: type: number nullable: true description: USD per hour for the machine. cost_usd: type: number nullable: true description: >- Machine cost so far, from when it is running (setup included). Final once the job ends. Null before the machine runs. log_bytes: type: integer description: Bytes of output stored. logs_truncated: type: boolean description: True when output passed the 10 MB cap and the middle was dropped. ListMeta: type: object description: Pagination metadata on list responses. properties: cursor: type: string nullable: true hasMore: type: boolean nullable: true total: type: integer nullable: true requestId: type: string nullable: true Error: type: object required: - error properties: error: type: object required: - code - message properties: code: type: string description: >- Machine-readable error code (e.g. `validation_error`, `unauthorized`, `not_found`, `insufficient_credits`, `rate_limited`, `internal_error`). message: type: string description: Human-readable error message. details: type: object additionalProperties: true description: Optional structured error context. responses: Unauthorized: description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: ApiKeyAuth: type: http scheme: bearer description: >- Use a Runcrate API key with the `rc_live_*` prefix as the bearer token. Create one at https://www.runcrate.ai/dashboard/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.