Skip to main content

Plans & Limits

The API is included in every Fleeta cloud subscription — there is no separate API fee. The plan that gives you the web viewer and live dashcam monitoring also sets what the API may do: its request rate, the scopes an API key can carry, and the monthly allowances. The plans themselves, and what they cost per camera, are on fleeta.io/pricing; this page only describes the API side of each plan.

What a Fleeta subscription includes — web viewer, live dashcam monitoring, Open API, AI assistants (MCP)

One subscription, four ways in: the web viewer, live dashcam monitoring, the Open API (REST, webhooks, SDK) and AI assistants over MCP. The API and the MCP connection are part of the plan — nothing else to buy.

Your tier comes from your subscription

The API tier is not something you choose at issuance — it is derived from your existing Fleeta subscription plan, along with your camera count. Issuing a key simply reads that subscription. To move up a tier, change your subscription; the API side follows. Subscription plans that have no Open API mapping cannot issue keys at all — the request is rejected with a 403.

See Fleeta plans and prices →

Plans at a glance​

Two things set your limits: the plan level and the number of cameras on it. Every camera you add raises the monthly call allowance; each plan also has a maximum camera count.

Fleeta planMax camerasrps (burst)ScopesMonthly API calls
Free11 (2)1300, fixed
Starter11 (3)4500 + 3,000 per camera
Standard103 (6)6500 + 7,000 per camera
Pro9910 (25)13500 + 10,000 per camera
Enterprise99925 (50)15500 + 15,000 per camera

For example, a Standard plan with 10 cameras gets 500 + 7,000 × 10 = 70,500 calls a month; an Enterprise plan with 200 cameras gets 3,000,500. See Rate Limits for enforcement details and 429 handling.

What each tier unlocks​

Scopes are cumulative — each tier includes everything below it (free 1 → starter 4 → standard 6 → pro 15 → enterprise 15 scopes):

  • free — device inventory (devices:read).
  • starter — adds GPS locations/trips, safety events, and usage lookup (gps:read, events:read, usage:read).
  • standard — adds fleet insights/reports and event video URL issuance (insights:read, video:read).
  • pro — adds everything else: device writes, GPS Export, SD-card media list/recall/deletion, geofences, webhooks, and audit logs (devices:write, gps:export, media:read, media:recall, media:write, geofences:read, geofences:write, webhooks:manage, audit:read). Webhook push subscriptions are available from the pro tier and above.
  • enterprise — the same scopes as pro. Enterprise differs in scale, not features: up to 999 cameras, a higher request rate, more video transfer per dollar, two concurrent GPS exports, and group-scoped keys.

The AI Assistants (MCP) connection uses the same key and the same scopes — vehicle status from Free, safety events and trips from Starter, video and reports from Standard, geofences and SD recordings from Pro. The full scope-by-tier matrix with per-scope descriptions is in the Authentication guide.

Volume quotas​

Two resources have monthly allowances of their own, separate from call volume, because their cost is not per call: video delivered to you and GPS export jobs. Like the call limit, both grow with what the plan is paid for.

BucketAllowance / monthAvailable from
transfer_bytes — video delivered to you (event video URLs + SD-card recalls)0.8 GB per $1 on Standard · 1 GB per $1 on Pro · 1.2 GB per $1 on Enterprisestandard (0 below)
export_job — GPS Export jobs created50 per camerapro (0 below)
export_concurrent — Export jobs running at oncefree/starter 0 · standard/pro 1 · enterprise 2 (fixed)standard

Per camera that is 5.6 GB a month on Standard, 10 GB on Pro and 18 GB on Enterprise — a Standard plan with 10 cameras has 56 GB, a Pro plan with 10 cameras 100 GB, an Enterprise plan with 100 cameras 1.8 TB. One GB here is 2³⁰ bytes, the same unit GET /v1/usage reports. The allowance is metered when a link is issued: an event video URL counts at the clip's size (a flat 6 MB), an SD-card recall at the recording's size (sizeBytes, or a flat 8 MB sub / 150 MB main estimate when the dashcam does not report it). A sub recording is 5–10 MB; a full-quality main recording is often 300 MB or more, so the same allowance buys roughly 700 sub recordings or 35 minutes of full-quality footage per camera on Standard, about twice that on Pro and three times on Enterprise. Thumbnails, listings, metadata, job status and GPS export files do not count. GET /v1/usage reports the bucket in bytes (unit: "bytes").

Exceeding a volume quota returns 403 + quota_exceeded (not 429) — worked examples and the error shape are in Rate Limits. Additional transfer packs for months that need more are planned for a later release; until then the way to get more is a higher plan or more cameras.

Data retention by plan​

The API reads the same data the web viewer shows, so it inherits the retention of your Fleeta plan (the full feature table is on fleeta.io/pricing). Once a window passes, the data is gone from the API too.

DataFreeStarterStandardProEnterprise
Event videos in the cloud — GET /v1/events/{eventId}/video2 days7 days30 days30 days90 days
GPS tracks — /trips, /trips/{tripId}/track, GPS Export——30 days90 days120 days
Cloud storage5 GB per account5 GB per camera10 GB per camera25 GB per camera50 GB per camera
API call logs — GET /v1/api-logs30 days raw · 13 months of daily totals, every plan
Recalled SD-card files — the download link from a recall jobAt least 2 days on the media server (each link valid about 24 hours), every plan

Two effects worth knowing before you build on it:

  • The GPS window applies to trips, tracks and exports alike. GET /v1/devices/{psn}/trips lists only trips that started inside your plan's window (a from earlier than the window is read as the start of the window), and GET /v1/trips/{tripId}/track answers 404 trip_not_found for a trip that started before it — treat that as "expired", not as a broken id. A GPS Export whose range ends before the window is rejected with 422 invalid_field carrying retentionDays and earliestFrom; a range that only starts before it is exported from the first day of the window. Free and Starter keep no GPS track history, so their trip list is empty.
  • Event records outlive their video. An event stays in GET /v1/events after its video window has passed — the row remains, channels empties and hasVideo turns false; only the video URL stops being issuable. Events the account deleted from cloud storage are removed from the list entirely.

API keys per organization​

Each organization can hold a limited number of active API keys — 1 on free, 10 on every paid tier. Issuing a key beyond the limit returns 409; revoke an unused key first. Revoked keys do not count.

When you hit a limit — overage policy​

Calls beyond the monthly cap are blocked. There is no pay-as-you-go overage billing, and unused calls do not roll over to the next month. Once the cap is reached, every further request returns 429 with a problem+json code of monthly_limit_exceeded plus a Retry-After header pointing at the next billing month (the 1st of the next month, UTC), when the counter resets. If you need more calls before the reset, move to a higher subscription plan or add cameras — see Rate Limits for the full response shape and handling guidance.

Plan changes and your keys​

  • No reissue needed for scope lineup changes. Keys issued without an explicit scope list (tier_default) resolve their tier's full scope set at request time — when a plan's scope lineup changes, those keys pick it up immediately, without reissuing. See Authentication.
  • Your key follows your subscription — no reissue on a plan change. Tier, camera limit and monthly call limit are re-read from your subscription at request time: a tier change (up or down) takes effect within about five minutes, and the monthly limit on the very next call. See Rate Limits.

Changing your plan or talking to sales​

Change your subscription

Plans are managed in the Fleeta web viewer, not in this portal. The API tier is derived from your subscription, so when the subscription changes — a tier up or down, cameras added or removed — the limits follow within minutes. See Rate Limits under Changing plan? Keep your key.

Open the web viewer

Fleets beyond the Enterprise camera cap, or anything the plans do not cover: contact sales.