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. Omitting the parameter or passing an empty object applies no metadata filter. An empty value, such as metadata[k]=, filters for that key with an empty string value. To select jobs with null metadata, send the literal query string metadata=null. Nullable caller types do not specify how a client serializes null for a deep-object parameter. Use a raw query parameter if the client omits null. Do not combine the two query forms.

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",
      "error": null,
      "finished_at": null,
      "trained_tokens": null,
      "seed": 42,
      "hyperparameters": {
        "batch_size": "auto",
        "learning_rate_multiplier": "auto",
        "n_epochs": "auto"
      },
      "method": {
        "type": "supervised",
        "supervised": {
          "hyperparameters": {
            "batch_size": "auto",
            "learning_rate_multiplier": "auto",
            "n_epochs": "auto"
          }
        }
      },
      "metadata": {
        "key": "value"
      }
    }
  ],
  "has_more": false
}

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",
      "error": null,
      "finished_at": null,
      "trained_tokens": null,
      "seed": 42,
      "hyperparameters": {
        "batch_size": "auto",
        "learning_rate_multiplier": "auto",
        "n_epochs": "auto"
      },
      "method": {
        "type": "supervised",
        "supervised": {
          "hyperparameters": {
            "batch_size": "auto",
            "learning_rate_multiplier": "auto",
            "n_epochs": "auto"
          }
        }
      },
      "metadata": {
        "key": "value"
      }
    }
  ],
  "has_more": false
}