Skip to main content
POST

Authentication

Pass your imp_ API key as a Bearer token:
Your user_id is resolved server-side from the key — do not include it in the request body.

Request body

deployment_id
string
required
The ID of the deployed model to call. Find this on the Models page in the dashboard.Example: clf-titanic-survived
inputs
object
required
A JSON object mapping feature column names to their values, exactly as they appear in the training dataset.

Response

prediction
any
The model’s output. For classification models this is the predicted class label (e.g. 0 or "yes"). For regression models it is a numeric value.
probability
number | null
Confidence score between 0 and 1 for the predicted class. Present for classification models, null for regression.
target
string | null
The name of the target column the model was trained to predict.

Rate limit headers

Every response includes standard rate-limit headers:
HeaderDescription
X-RateLimit-LimitRequests allowed in the current 60-second window
X-RateLimit-RemainingRequests remaining in the current window
X-RateLimit-ResetUnix timestamp when the window resets
Retry-AfterSeconds to wait before retrying (only on 429)