Get Training Status

Endpoint

GET /v1/forms/{id}/training-status

Description

Retrieves the training status of a previously fine-tuned form. This endpoint is useful to track whether the fine-tuning process has completed, is still running, or has failed.

The form ID must be provided in the path. This call returns a status object describing the current state of the training job.

Request

Path Parameters

Parameter	Required	Description
id	✓	The ID of the form being fine-tuned

Headers

Header	Required	Description
Authorization	✓	Bearer YOUR_API_KEY
Authorization	✓	Bearer token for internal downstream auth

Responses

Success — 200 OK

{
    "id": "ts_fb10ddb50e534ecea16ba9308749fec9",
    "object": "training_status",
    "status": {
        "status": "Completed",
        "type": "Automatic",
        "fields_total": 22,
        "fields_finetuned": 22,
        "duration": 129,
        "cost": 0,
        "version": "Jul 2, 2025",
        "finetuned_by": "[email protected]"
    }
}

Error — 500 Internal Server Error

Returned when the downstream service fails to respond or encounters an unexpected error during status retrieval.

{
  "error_message": "ProcessingApi error",
  "status_code": 500
}