Limits
Numeric ceilings in solarOS: API limits, webhook delivery, plan capacity, and upload sizes.
Numeric ceilings you may hit while using solarOS or its API.
API
| Limit | Value |
|---|---|
| Rate limit per API key | 5,000 requests per hour by default. There's no self-service control; contact solarOS support to raise or lower it. |
| Page size | 50 records per page by default, 100 maximum. |
| Idempotency-Key window | An Idempotency-Key protects a retry for 24 hours. After that, reusing the same key creates a new record instead of replaying the original response. |
| External Reference batch lookup | 1 to 200 lookups per call. |
Rate-limit response headers are documented in the API reference.
Webhooks
| Limit | Value |
|---|---|
| Delivery timeout | 10 seconds. |
| Retries | Up to 8 attempts, with exponential backoff starting at 1 minute and capped at 1 hour between attempts. |
| Payload retention | 30 days. |
| Delivery response retention | 7 days. |
Plans
Each solarOS plan includes a set number of quotes and agreements per month, and a number of technician seats for scheduling. Once you're over the included amount, agreements are billed as overage; quote overage depends on whether your organization has turned on pay-per-quote.
| Plan | Included quotes | Included agreements | Technician seats |
|---|---|---|---|
| Starter | 75 per month | 10 per month | 1 |
| Growth | 500 per month | 60 per month | 5 |
| Enterprise | Unlimited | Unlimited | Unlimited |
Enterprise is arranged with solarOS rather than chosen in the app. Your organization's actual numbers are shown on Settings → Billing & payments → Your solarOS plan. A custom plan can be set up with different numbers than shown here.
File uploads
| Upload | Maximum size |
|---|---|
| Attachments | 50 MB |
| Videos | 512 MB |
| Photos (technician app) | 50 MB |
Was this page helpful?