• Welcome
  • API Reference
OverviewGetting StartedAI assistants (MCP)Home AssistantRate limitsPay-per-use (x402)Data FormatsExamplesArcGIS layer accessNowcast archive (Icechunk)
powered by Zuplo
Welcome

Rate limits

Free

Any Precip account can use the API through an AI assistant (MCP). Free accounts don't get an API key.

LimitValue
Requests per month25 (successful requests only; the month starts with your first request)
Requests per minute10
Locations per request1
Date range per request31 days
Bulk export (POST /api/v1/reports)Not included

Personal

Included with any paid Precip plan, for non-commercial use. Get your key in the Precip app under Settings → API & AI assistants.

LimitValue
Requests per minute10
Requests per day100
Locations per request1
Date range per request31 days
Bulk export (POST /api/v1/reports)Not included

Requests from your API key and from AI assistants signed in to your account share the same limits.

Commercial

Commercial use is available through our standard API access agreements and offers higher limits, multiple locations per request, and bulk export. Contact us to discuss customized pricing and easy subscription billing under commercial terms.

Pay-per-use (x402)

Pay-per-use requests have no account limits. You pay for each request. See pay-per-use.

Errors

When a request goes over a limit, the response body has an error message, a code, and an upgradeUrl with a way to get more.

StatuscodeMeaning
429hobby_api_rate_limited_minuteToo many requests this minute. Wait for the number of seconds in the Retry-After header.
429hobby_api_rate_limited_dayDaily limit reached. Wait for the number of seconds in the Retry-After header.
403free_api_quota_exhaustedThe free monthly allowance is used up. The message gives the reset date.
403hobby_api_too_many_locationsMore than one location in the request.
403hobby_api_date_span_exceededDate range longer than 31 days.
403hobby_api_bulk_export_forbiddenBulk export needs commercial access.

AI assistants get the same message as the text of the tool error.

Last modified on October 31, 2026
Home AssistantPay-per-use (x402)
On this page
  • Free
  • Personal
  • Commercial
  • Pay-per-use (x402)
  • Errors