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

# Get transaction status

> Polls the processing status of any asynchronous write operation. Use the tracking_id returned by the create endpoint.

<ParamField header="x-api-key" type="string" required>
  API key with `inventory:read` scope.
</ParamField>

<ParamField path="trackingId" type="string" required>
  The `tracking_id` returned by a create operation (goods receipt, stock count, waste event, transfer, or production batch).
</ParamField>

<ResponseField name="status" type="string">
  `PENDING`, `PROCESSING`, `COMPLETED`, or `FAILED`.
</ResponseField>

<ResponseField name="error" type="object">
  Present only when `status` is `FAILED`. Contains `kind` and `message`.
</ResponseField>

<ResponseExample>
  ```json 200 (COMPLETED) theme={null}
  {
    "status": "COMPLETED"
  }
  ```

  ```json 200 (FAILED) theme={null}
  {
    "status": "FAILED",
    "error": {
      "kind": "insufficient_stock",
      "message": "Insufficient stock for item itm_chicken_01..."
    }
  }
  ```

  ```json 200 (PENDING) theme={null}
  {
    "status": "PENDING"
  }
  ```
</ResponseExample>
