When you create a Planet Subscription with a start_time in the past, the Subscriptions API treats every scene that intersects your area of interest (AOI) between that start time and now as a backfill delivery. Backfill deliveries draw on your plan immediately, the same way forward-going deliveries do. A subscription opened with a start date several years ago can therefore exhaust a small or test plan in a single run.

This article explains how the API charges for backfill, what to check before you create a subscription, and what to do if a test subscription consumed more than expected.

How backfill consumption works

Each Planet Subscription has a start_time and an end_time. The API classifies the subscription based on those values:

• Backfill: both start_time and end_time are in the past.
• Forwardfill: end_time is in the future.
• Mixed: start_time is in the past and end_time is in the future. The API delivers a backfill segment for the historical window, then continues forwardfill for the remaining period.

For each backfill or mixed subscription, the API finds every Planet scene that intersects the AOI between start_time and the current time, then processes and delivers them according to the subscription's tools, source, and filters. Cancelling the subscription stops further deliveries but does not refund what has already been consumed.

Which applies to you

Your plan is shown in your Planet account. Plans on the current packages are charged in monitoring credits. Plans bought before the change are charged against Area Under Management (AUM), now called Planet Agriculture, and Processing Units (PUs).

If your plan uses monitoring credits

Credits are consumed based on the total area of imagery delivered. Credit rates also vary with data recency, so historical imagery is charged at the rate for its recency band.

You will receive notifications as you use your credits so you can manage consumption. Overages are not permitted, so requests that would exceed your available credits will not be processed.

If your plan uses download quota (sq km)

Applies to plans bought before Planet moved to monitoring credits. AUM is charged based on the AOI area and the historical date range. PUs are charged for the processing performed on each delivered scene.

A 0.44 km² AOI with start_time set to 2016-01-01 can consume well over 1,000 km² of AUM and tens of thousands of PUs as the API works through ten years of PlanetScope archive.

Estimating the cost: multiply your AOI area (in square kilometres) by the number of historical days between start_time and today, then compare the result against your remaining AUM. If the estimate exceeds your remaining quota, narrow the date range or the AOI before submitting.

You can also ask your account team about enabling hard caps on the plan tier, so the API rejects requests that would exceed prepaid quota rather than processing them.

Check these values before you create a subscription

1. Review start_time and end_time. Confirm both values are the dates you actually want delivered. A test subscription that only needs to verify the API contract can use a start_time within the last day or two.
2. Consider how much imagery the window will return. A long historical window over even a small AOI can return a large volume of scenes, and every delivered scene is charged.
3. Check your remaining balance on the Insights Platform account page before submitting.
4. Test with a one-day window first. For new integrations, set start_time to yesterday and end_time to today. This verifies the API call without consuming a meaningful share of your plan.

What an update (PUT) does and does not change

You can update a running forwardfill subscription by sending a PUT to /subscriptions/{id}. The update applies to future item publications and deliveries only. The API does not redeliver items already produced and does not refund past deliveries.

• Changing the AOI geometry on a pending subscription applies the new geometry to all deliveries in the subscription window, because no items have been published yet.
• Changing the AOI geometry on a running subscription applies the new geometry to items published from the moment of the PUT forward. Items already published with the previous geometry remain delivered with that geometry.
• start_time cannot be updated if it is in the past. Other immutability rules are listed in the Update a subscription section of the Subscriptions Mechanics page.

If a subscription consumed more than expected

1. Cancel the subscription if it is still running. Cancellation does not refund what has been consumed, but it prevents further consumption.
2. Open a support ticket with the subscription IDs, the AOI, the start_time and end_time values, and the consumption figures from your account page.

Related resources

• Planet Subscriptions API overview
• Planet Subscriptions API mechanics
• Planet Agriculture (previously Area Under Management)
• Processing Units (PUs): what they are and how they are consumed
• Subscriptions API FAQs