Skip to content
Primary navigation

List fine-tuning events

client.fineTuning.jobs.listEvents(stringfineTuningJobID, JobListEventsParams { after, limit } query?, RequestOptionsoptions?): CursorPage<FineTuningJobEvent { id, created_at, level, 4 more } >
GET/fine_tuning/jobs/{fine_tuning_job_id}/events

Get status updates for a fine-tuning job.

ParametersExpand Collapse
fineTuningJobID: string
query: JobListEventsParams { after, limit }
after?: string

Identifier for the last event from the previous pagination request.

limit?: number

Number of events to retrieve.

ReturnsExpand Collapse
FineTuningJobEvent { id, created_at, level, 4 more }

Fine-tuning job event object

id: string

The object identifier.

created_at: number

The Unix timestamp (in seconds) for when the fine-tuning job was created.

level: "info" | "warn" | "error"

The log level of the event.

One of the following:
"info"
"warn"
"error"
message: string

The message of the event.

object: "fine_tuning.job.event"

The object type, which is always "fine_tuning.job.event".

data?: unknown

The data associated with the event.

type?: "message" | "metrics"

The type of event.

One of the following:
"message"
"metrics"

List fine-tuning events

import OpenAI from "openai";

const openai = new OpenAI();

async function main() {
  const list = await openai.fineTuning.list_events(id="ftjob-abc123", limit=2);

  for await (const fineTune of list) {
    console.log(fineTune);
  }
}

main();
{
  "object": "list",
  "data": [
    {
      "object": "fine_tuning.job.event",
      "id": "ft-event-ddTJfwuMVpfLXseO0Am0Gqjm",
      "created_at": 1721764800,
      "level": "info",
      "message": "Fine tuning job successfully completed",
      "data": null,
      "type": "message"
    },
    {
      "object": "fine_tuning.job.event",
      "id": "ft-event-tyiGuB72evQncpH87xe505Sv",
      "created_at": 1721764800,
      "level": "info",
      "message": "New fine-tuned model created: ft:gpt-4o-mini:openai::7p4lURel",
      "data": null,
      "type": "message"
    }
  ],
  "has_more": true
}
Returns Examples
{
  "object": "list",
  "data": [
    {
      "object": "fine_tuning.job.event",
      "id": "ft-event-ddTJfwuMVpfLXseO0Am0Gqjm",
      "created_at": 1721764800,
      "level": "info",
      "message": "Fine tuning job successfully completed",
      "data": null,
      "type": "message"
    },
    {
      "object": "fine_tuning.job.event",
      "id": "ft-event-tyiGuB72evQncpH87xe505Sv",
      "created_at": 1721764800,
      "level": "info",
      "message": "New fine-tuned model created: ft:gpt-4o-mini:openai::7p4lURel",
      "data": null,
      "type": "message"
    }
  ],
  "has_more": true
}