Skip to main content
GET
/
api
/
users
/
{username}
/
fine_tunes
List fine-tunes for a user
curl --request GET \
  --url https://hub.oxen.ai/api/users/{username}/fine_tunes \
  --header 'Authorization: Bearer <token>'
{
  "fine_tunes": [
    {
      "base_model": "<string>",
      "created_at": "<string>",
      "id": "<string>",
      "name": "<string>",
      "status": "<string>",
      "updated_at": "<string>"
    }
  ],
  "status": "<string>",
  "status_message": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
username
string
required

Username

Query Parameters

​
page
integer

Page number (1-indexed)

​
page_size
integer

Number of items per page

​
search
string

Search across fine-tune name, display name, base model, and repository (case-insensitive substring match). For example: 'qwen', 'ox/Delorean', 'customer-support'.

​
status
string

Filter by status. One of: created, tokenizing, enqueued, running, completed, stopped, errored, deployed

​
created_by
string

Filter by creator username (exact match)

​
sort
string

Sort order by creation date: 'newest' (default) or 'oldest'

Response

List fine-tunes response

Standard wrapper for fine-tune list responses.

​
fine_tunes
FineTune · object[]

List of fine-tune job resources

​
status
string

High-level status string (for example, 'success').

​
status_message
string

Human-readable status message (for example, 'resource_found').