> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fastino.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List training jobs

> List and filter Fastino training jobs.

`GET /v1/training-jobs`

Returns training jobs visible to the authenticated account.

## Request

<ParamField header="X-API-Key" type="string" required>
  Your Fastino API key.
</ParamField>

<ParamField query="status" type="string">
  Filter by persisted job status.
</ParamField>

<ParamField query="project_id" type="string">
  Filter by project ID.
</ParamField>

<ParamField query="limit" type="integer" default="200">
  Page size from `1` through `200`.
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Number of matching jobs to skip.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.fastino.ai/v1/training-jobs?status=complete&limit=50&offset=0" \
    -H "X-API-Key: $FASTINO_API_KEY"
  ```
</RequestExample>

## Response

<ResponseField name="success" type="boolean">
  Whether the request succeeded.
</ResponseField>

<ResponseField name="training_jobs" type="object[]">
  Training-job records for this page.
</ResponseField>

<ResponseField name="count" type="integer">
  Number of jobs in this page.
</ResponseField>

<ResponseField name="total" type="integer">
  Total number of matching jobs before pagination.
</ResponseField>

<ResponseField name="has_more" type="boolean">
  Whether another page exists after this one.
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "training_jobs": [],
    "count": 0,
    "total": 0,
    "has_more": false
  }
  ```
</ResponseExample>

Invalid pagination values return `422`.