---
title: "Run Predictions"
method: POST
path: "/v1/predict"
tags: ["Prediction"]
deprecated: true
---

# Run Predictions

`POST /v1/predict`

> **Deprecated.**

**Deprecated:** Prefer `tabpfn-client` or `POST /tabpfn/predict`. See the [TabPFN-3 changelog](/changelog/tabpfn-3).

Run inference using a previously fitted TabPFN model. Upload your test dataset and specify the model ID from your previous `/v1/fit` call. The endpoint returns predicted probabilities or values depending on the task type.

## Response `200`

Prediction completed successfully — returns predicted values or probabilities depending on the task.

- PredictionResponse
  - `duration_seconds` integer, required — Time taken (in seconds) to complete the prediction.
  - `prediction` union, required — The prediction output. Format depends on task and output_type: - **Regression**: List of floats (e.g., `[1250.5, 3200.8, 980.2]`) - **Classification with `output_type: probas`**: List of lists (probabilities) (e.g., `[[0.1, 0.9], [0.8, 0.2]]`) - **Classification with `output_type: preds`**: List of classes (e.g., `["class_0", "class_1"]`)
    - number[] — Regression predictions or classification probabilities
    - array[] — Classification probabilities (list of lists)
      - number[]
    - string[] — Classification predictions (list of class names)
  - `task` 'classification' | 'regression', required — Specifies the type of task to perform — either classification or regression.
  - `params` object — The inference parameters that were used during prediction.
    - `average_before_softmax` boolean — Whether to average before applying softmax.
    - `categorical_features_indices` integer[], nullable — Indices of categorical features.
    - `ignore_pretraining_limits` boolean — Whether to ignore pretraining limits.
    - `inference_config` object, nullable — Additional inference configuration parameters.
    - `inference_precision` string — Inference precision (e.g., "auto", "float32", "float16").
    - `model_path` string — Model checkpoint path used for inference.
    - `n_estimators` integer — Number of ensemble estimators used.
    - `n_preprocessing_jobs` integer — Number of preprocessing jobs.
    - `random_state` integer, nullable — Random seed used for reproducibility.
    - `softmax_temperature` number — Softmax temperature parameter used.
  - `used_credits` integer, required — The number of credits consumed by this API call.
  - `remaining_quota` integer, required — Your remaining credit balance after this request.

## Other responses

- `400` — Invalid request — dataset file missing or malformed input.
- `401` — Unauthorized — authentication required or credentials invalid. **Possible causes:** - Missing or malformed `Authorization` header - Invalid or expired JWT token - User not found (token references a deleted account) - JWT decode errors
- `403` — Forbidden — user account not verified or insufficient permissions.
- `404` — Model not found — the provided model ID does not exist or has expired.
- `422` — Validation error — incorrect or missing fields in the request.

---

[API](https://skmtc.dev/priorlabs/apis/tabpfn-api.md) · [All operations](https://skmtc.dev/priorlabs/apis/tabpfn-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/priorlabs/tabpfn-api/revisions/c893364bdb13/schema)