> ## 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. # Get a preference (DPO) job > One preference job, with its state and progress. ## OpenAPI ````yaml openapi/prentis-training.openapi.yaml GET /accounts/{account}/dpoJobs/{job} 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}/dpoJobs/{job}: get: tags: - training summary: Get a preference (DPO) job description: One preference job, with its state and progress. operationId: getDpoJob parameters: - $ref: '#/components/parameters/Account' - $ref: '#/components/parameters/Job' responses: '200': headers: x-request-id: $ref: '#/components/headers/x-request-id' content: application/json: schema: $ref: '#/components/schemas/TrainingJob' example: name: accounts/my-account/trainingJobs/01K7AY0M2N4P6R8T0V2X4Z6B8D jobId: 01K7AY0M2N4P6R8T0V2X4Z6B8D jobType: JOB_TYPE_DPO state: JOB_STATE_RUNNING baseModel: accounts/maas/models/your-base-model progress: percent: 20 epoch: 1 totalEpochs: 1 processedTokens: '218000' createTime: '2026-10-10T09:00:00Z' startTime: '2026-10-10T09:00:48Z' description: OK. '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/dpoJobs/01K7AY0M2N4P6R8T0V2X4Z6B8D \ -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. Job: name: job in: path required: true schema: type: string maxLength: 64 description: >- The job's id: the last segment of its name (accounts/{account}/trainingJobs/{job}). A job is only found through the collection of its own type -- an SFT job through supervisedFineTuningJobs, a DPO job through dpoJobs. 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: 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 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 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' 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: 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.