Skip to main content
This page is the source of truth. GET /v1/model-limits needs no API key and returns the limits your deployment is serving.

Per job

A table has to clear all three of rows, columns and cells, so the wider it is the shorter it has to be: at 2 000 columns you get 50 000 rows, not 1 000 000. Scored rows are counted on their own and do not draw on the cell budget. The upload ceiling is a default. A deployment can be configured lower, and the override is not reflected in /v1/model-limits, so ask your administrator if an upload is rejected below 5 000 000 000 bytes.

Per minute

Authenticated requests are limited to 60 per minute per user. All of a user’s API keys share one allowance; other users in the organization have their own. GET /v1/model-limits is unauthenticated and does not count. The 61st request returns rate_limited with Retry-After and RateLimit-* headers. The window is the clock minute, not a sliding one, so 60 requests late in one minute and 60 early in the next are both allowed.

Per day

The row quota counts input rows only — output rows are billed but do not draw on it. Quota is reserved at submit and released on completion, so a burst of concurrent submits can hit quota_exceeded before any of them has run.

Forecasts

Forecast cells are context rows × (covariate columns + 1) — the target column counts too. A forecast never uses a fitted context, so every call ships the whole context window and is measured against these limits in full.

Fitted contexts

A fitted context expires after 30 days of inactivity, with a 90-day absolute lifetime. Successful predictions extend the inactivity deadline. Predicting against an expired context raises fitted_context_expired — fit again.

What each ceiling returns

The dataset_too_large envelope names the dimension you breached, the value you sent and the limit — the first one, if you breach several at once. Only rate_limited is retryable, so a client that retries every 429 will loop against quota_exceeded. See Errors for the envelope and the full catalogue of codes.

Additional resources

Errors

Common errors and their causes

Usage and billing

Learn about Hollerith’s pricing structure