---
title: "Check one training job"
method: GET
path: "/api/agent/v1/jobs/{jobId}"
tags: ["Training"]
---

# Check one training job

`GET /api/agent/v1/jobs/{jobId}`

## Request

- Base URL: `https://nicevois.com`
- URL: `https://nicevois.com/api/agent/v1/jobs/{jobId}`
- Auth: HTTP bearer

Returns truthful status, epoch progress, ETA, and completed artifacts. Poll no more than once every 15 seconds.

## Path parameters

- `jobId` string, required

## Response `200`

Current private job state.

- TrainingJob
  - `id` string, required
  - `status` string, required
  - `message` string, nullable
  - `modelName` string, nullable
  - `epochs` integer, nullable
  - `currentEpoch` integer, nullable, required
  - `durationSeconds` number, nullable
  - `createdAt` string, date-time, nullable
  - `updatedAt` string, date-time, nullable
  - `startedAt` string, date-time, nullable
  - `completedAt` string, date-time, nullable
  - `estimatedCompletionAt` string, date-time, nullable
  - `estimatedRemainingSeconds` number, nullable
  - `etaText` string, nullable
  - `expiresAt` string, date-time, nullable
  - `subscriptionCreditCents` integer
  - `balanceDueCents` integer
  - `upload` UploadInstruction
    - `method` 'PUT', required
    - `url` string, uri, required
    - `headers` object, required
  - `artifacts` Artifacts
    - `pth` Artifact
      - `name` string, nullable
      - `sizeBytes` integer, nullable
      - `downloadUrl` string, uri
    - `index` Artifact
      - `name` string, nullable
      - `sizeBytes` integer, nullable
      - `downloadUrl` string, uri
    - `package` Artifact
      - `name` string, nullable
      - `sizeBytes` integer, nullable
      - `downloadUrl` string, uri
  - `links` object, required
    - `status` string, uri, required
    - `start` string, uri, required

## Other responses

- `401`: Missing or invalid NiceVois agent credential.
- `404`: The private job was not found for this credential.

---

[API](https://skmtc.dev/nicevois/apis/nicevois-agent-api.md) · [All operations](https://skmtc.dev/nicevois/apis/nicevois-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nicevois/apis/nicevois-agent-api/revisions/6ef41022a089?raw)