> ## Documentation Index > Fetch the complete documentation index at: https://docs.compute.prentis.ai/llms.txt > Use this file to discover all available pages before exploring further. # List supervised fine-tuning jobs > The supervised fine-tuning (SFT) jobs in this account, newest first. Preference (DPO) jobs are listed separately under dpoJobs. ## OpenAPI ````yaml openapi/prentis-training.openapi.yaml GET /accounts/{account}/supervisedFineTuningJobs openapi: 3.1.0 info: title: Prentis Training API version: 0.1.0 summary: >- Fine-tune models on your own data, with the same API key you use for inference. description: > Upload a dataset, start a fine-tuning job on it, and watch it train -- from code, with the API key you already use for inference. The jobs and datasets are the same ones the console shows: anything started here appears there, and the other way round. Every path is under `/v1/accounts/{account}`, where `{account}` is the account the key belongs to. A key reaches its own account only. A finished job produces a model in your account (`accounts/{account}/models/{outputModelId}`), listed under Custom models in the console. To call it, deploy it on a dedicated deployment and send inference requests to the deployment (`accounts/{account}/deployments/{deployment}`). servers: - url: https://compute.prentis.ai/v1 description: Production security: - bearerAuth: [] tags: - name: training - name: datasets paths: /accounts/{account}/supervisedFineTuningJobs: get: tags: - training summary: List supervised fine-tuning jobs description: >- The supervised fine-tuning (SFT) jobs in this account, newest first. Preference (DPO) jobs are listed separately under dpoJobs. operationId: listSupervisedFineTuningJobs parameters: - $ref: '#/components/parameters/Account' - $ref: '#/components/parameters/PageSize' - $ref: '#/components/parameters/PageToken' - $ref: '#/components/parameters/JobFilter' responses: '200': headers: x-request-id: $ref: '#/components/headers/x-request-id' content: application/json: schema: $ref: '#/components/schemas/ListSupervisedFineTuningJobsResponse' example: supervisedFineTuningJobs: - name: >- accounts/my-account/trainingJobs/01K7AX3V9Q2M8T4R6Y0B1C5D7E jobId: 01K7AX3V9Q2M8T4R6Y0B1C5D7E jobType: JOB_TYPE_SFT state: JOB_STATE_RUNNING baseModel: accounts/maas/models/your-base-model inputDatasetVersion: accounts/my-account/datasets/support-chats/versions/1 progress: percent: 40 epoch: 1 totalEpochs: 2 processedTokens: '428000' createTime: '2026-10-10T08:00:00Z' startTime: '2026-10-10T08:01:12Z' nextPageToken: '' description: OK. '400': $ref: '#/components/responses/Error400' '401': $ref: '#/components/responses/Error401' '403': $ref: '#/components/responses/Error403' '404': $ref: '#/components/responses/Error404' '500': $ref: '#/components/responses/Error500' '503': $ref: '#/components/responses/Error503' x-codeSamples: - lang: curl label: cURL source: >- curl "https://compute.prentis.ai/v1/accounts/my-account/supervisedFineTuningJobs?filter=state:RUNNING" \ -H "Authorization: Bearer $PRENTIS_API_KEY" components: parameters: Account: name: account in: path required: true schema: type: string maxLength: 64 description: >- Your account id -- the one in the console's address bar (my-account for this key). It must be the account the key belongs to. PageSize: name: pageSize in: query required: false schema: type: integer minimum: 1 maximum: 200 default: 50 description: How many items to return, up to 200. Defaults to 50. PageToken: name: pageToken in: query required: false schema: type: string description: >- The nextPageToken from the previous page, to fetch the next one. Keep every other parameter the same while paging. JobFilter: name: filter in: query required: false schema: type: string maxLength: 256 description: Narrow the list by state, for example state:RUNNING. headers: x-request-id: schema: type: string required: true description: >- On every response, successes and errors alike. Quote it when you ask us about a call. Retry-After: schema: type: integer minimum: 0 description: How many seconds to wait before retrying, on the responses that set it. schemas: ListSupervisedFineTuningJobsResponse: type: object properties: supervisedFineTuningJobs: type: array items: $ref: '#/components/schemas/TrainingJob' nextPageToken: type: string TrainingJob: type: object properties: name: type: string jobId: type: string jobType: type: string enum: - JOB_TYPE_SFT - JOB_TYPE_DPO state: type: string enum: - JOB_STATE_QUEUED - JOB_STATE_RUNNING - JOB_STATE_CHECKPOINTING - JOB_STATE_FINALIZING - JOB_STATE_SUCCEEDED - JOB_STATE_FAILED - JOB_STATE_CANCELLED - JOB_STATE_EXPIRED stateDetail: type: string errorClass: type: string baseModel: type: string inputDatasetVersion: type: string evaluationDatasetVersion: type: string outputModel: type: string config: $ref: '#/components/schemas/TrainingConfig' progress: $ref: '#/components/schemas/JobProgress' estimatedCost: allOf: - $ref: '#/components/schemas/Money' execution: $ref: '#/components/schemas/JobExecution' createdBy: type: string createTime: type: string format: date-time startTime: type: string format: date-time completeTime: type: string format: date-time ErrorResponse: type: object required: - error properties: error: type: object required: - message - type - code properties: message: type: string type: type: string enum: - invalid_request_error - authentication_error - permission_error - not_found_error - rate_limit_error - server_error - service_unavailable - billing_error code: type: string enum: - INVALID_REQUEST - INVALID_API_KEY - OPERATION_NOT_ALLOWED - TENANT_SUSPENDED - AGREEMENT_REQUIRED - DATA_RESIDENCY_VIOLATION - PROVIDER_NOT_ALLOWED - PROVIDER_SERVICE_UNAVAILABLE - INSUFFICIENT_BALANCE - PAYMENT_REQUIRED - MODEL_NOT_FOUND - MODEL_ALREADY_EXISTS - DATASET_NOT_FOUND - DATASET_ALREADY_EXISTS - DATASET_STATE_INVALID - DATASET_IN_USE - DATASET_TOO_LARGE - JSONL_LINE_NOT_OBJECT - JSONL_MISSING_FIELD - JSONL_ENCODING - JOB_NOT_FOUND - JOB_STATE_INVALID - TRAINING_RUN_ABANDONED - TRAINING_TOKENIZE_FAILED - TRAINING_BASE_NOT_EXPORTABLE - IDEMPOTENCY_CONFLICT - QUOTA_EXCEEDED - INTERNAL - STORAGE_UNAVAILABLE param: type: - string - 'null' TrainingConfig: type: object required: - outputModelId properties: outputModelId: type: string maxLength: 64 loraRank: type: integer learningRate: type: string epochs: type: integer batchSize: type: integer maxContextLength: type: integer earlyStop: type: boolean evalAutoCarveoutBasisPoints: type: integer minimum: 0 maximum: 9999 lrSchedule: type: string warmupSteps: type: integer dpoBeta: type: string JobProgress: type: object properties: percent: type: integer minimum: 0 maximum: 100 epoch: type: integer totalEpochs: type: integer processedTokens: type: string format: int64 updateTime: type: string format: date-time step: type: string format: int64 totalSteps: type: string format: int64 recent: type: array maxItems: 200 items: $ref: '#/components/schemas/TrainingMetricPoint' skippedExamples: type: string format: int64 Money: type: object properties: amount: type: string currency: type: string JobExecution: type: object properties: providerDisplayName: type: string thirdParty: type: boolean TrainingMetricPoint: type: object properties: step: type: string format: int64 epoch: type: integer loss: type: string evalLoss: type: string learningRate: type: string time: type: string format: date-time responses: Error400: headers: x-request-id: $ref: '#/components/headers/x-request-id' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- `error.code` is one of: `DATASET_STATE_INVALID`, `INVALID_REQUEST`, `JSONL_ENCODING`, `JSONL_LINE_NOT_OBJECT`, `JSONL_MISSING_FIELD`, `TRAINING_BASE_NOT_EXPORTABLE`, `TRAINING_TOKENIZE_FAILED`. See the Errors page for what each one means, whether it is safe to retry, and whether it is billed. Error401: headers: x-request-id: $ref: '#/components/headers/x-request-id' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- `error.code` is one of: `INVALID_API_KEY`. See the Errors page for what each one means, whether it is safe to retry, and whether it is billed. Error403: headers: x-request-id: $ref: '#/components/headers/x-request-id' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- `error.code` is one of: `AGREEMENT_REQUIRED`, `DATA_RESIDENCY_VIOLATION`, `OPERATION_NOT_ALLOWED`, `PROVIDER_NOT_ALLOWED`, `PROVIDER_SERVICE_UNAVAILABLE`, `TENANT_SUSPENDED`. See the Errors page for what each one means, whether it is safe to retry, and whether it is billed. Error404: headers: x-request-id: $ref: '#/components/headers/x-request-id' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- `error.code` is one of: `DATASET_NOT_FOUND`, `JOB_NOT_FOUND`, `MODEL_NOT_FOUND`. See the Errors page for what each one means, whether it is safe to retry, and whether it is billed. Error500: headers: x-request-id: $ref: '#/components/headers/x-request-id' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- `error.code` is one of: `INTERNAL`, `TRAINING_RUN_ABANDONED`. See the Errors page for what each one means, whether it is safe to retry, and whether it is billed. Error503: headers: x-request-id: $ref: '#/components/headers/x-request-id' Retry-After: $ref: '#/components/headers/Retry-After' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- `error.code` is one of: `STORAGE_UNAVAILABLE`. See the Errors page for what each one means, whether it is safe to retry, and whether it is billed. securitySchemes: bearerAuth: type: http scheme: bearer description: >- `Authorization: Bearer ` -- the same key as inference. A key reaches the account it belongs to and no other. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.