Skip to content

For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.

List fine-tuning jobs

$ openai fine-tuning:jobs list

GET/fine_tuning/jobs

List your organization’s fine-tuning jobs

ParametersExpand Collapse

--after: optional string

Identifier for the last job from the previous pagination request.

--limit: optional number

Number of fine-tuning jobs to retrieve.

--metadata: optional map[string]

Optional metadata filter. To filter, use the syntax metadata[k]=v. Alternatively, set metadata=null to indicate no metadata.

ReturnsExpand Collapse

ListPaginatedFineTuningJobsResponse: object { data, has_more, object }

data: array of FineTuningJob { id, created_at, error, 16 more }

View schema details

has_more: boolean

object: "list"

List fine-tuning jobs

openai fine-tuning:jobs list \
  --api-key 'My API Key'

{
  "object": "list",
  "data": [
    {
      "object": "fine_tuning.job",
      "id": "ftjob-abc123",
      "model": "gpt-4o-mini-2024-07-18",
      "created_at": 1721764800,
      "fine_tuned_model": null,
      "organization_id": "org-123",
      "result_files": [],
      "status": "queued",
      "validation_file": null,
      "training_file": "file-abc123",
      "metadata": {
        "key": "value"
      }
    },
    { ... },
    { ... }
  ], "has_more": true
}

Returns Examples

{
  "object": "list",
  "data": [
    {
      "object": "fine_tuning.job",
      "id": "ftjob-abc123",
      "model": "gpt-4o-mini-2024-07-18",
      "created_at": 1721764800,
      "fine_tuned_model": null,
      "organization_id": "org-123",
      "result_files": [],
      "status": "queued",
      "validation_file": null,
      "training_file": "file-abc123",
      "metadata": {
        "key": "value"
      }
    },
    { ... },
    { ... }
  ], "has_more": true
}