---
title: "Get training request"
method: GET
path: "/fields/{field_id}/train/{request_id}"
tags: ["Training"]
---

# Get training request

`GET /fields/{field_id}/train/{request_id}`

## Request

- Base URL: `https://us.app.zuva.ai/api/v2`
- URL: `https://us.app.zuva.ai/api/v2/fields/{field_id}/train/{request_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/zuva/apis/zuva-docai/docs/fields/:field_id/train/:request_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves the status of a field training request.

## Path parameters

- `field_id` string, required
- `request_id` string, required

## Response `200`

The status of the training request

- TrainingRequestStatus
  - `error` HttpError
    - `error` HttpErrorDetails, required
      - `code` string, required: A unique string identifying the error.
      - `message` string, required: An error message providing more details and potential steps to resolve.
  - `field_id` string, required
  - `request_id` string, required
  - `status` 'queued' | 'processing' | 'complete' | 'failed', required
  - `span_issues` SpanIssue[]
    - `file_id` string
    - `span_problems` SpanProblems[]
      - `index` integer
      - `spans` Spans[]
        - `end` integer
        - `start` integer
        - `label` integer
      - `issue_type` string

## Other responses

- `400`: Invalid request ID
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Request not found.
- `500`: Internal Server Error

## Changes

- **2023-12-13** `51f2a4c5de2e`: 1 info
  - added the optional property `span_issues` to the response with the `200` status

[Operation history](https://skmtc.dev/zuva/apis/zuva-docai/changes/fields/:field_id/train/:request_id/get.md)

---

[API](https://skmtc.dev/zuva/apis/zuva-docai.md) - [All operations](https://skmtc.dev/zuva/apis/zuva-docai/llms.txt) - [OpenAPI document](https://skmtc.dev/zuva/apis/zuva-docai/revisions/7397ad071d55?raw)