Use this endpoint to refresh old data. If an availability object you care about has not been updated recently, you can request an updated copy here.

This API is a single idempotent endpoint that both queues a refresh and reports the status. Each call queues whichever of the given items are stale (not updated in the last 3 hours) and not already being refreshed, and reports the current state of everything else, so you poll by repeating the same call until complete is true. Queued items are typically refreshed within a minute.

Refreshing cached data is an async, queued process on the seats.aero backend. This queue can overfill or experience low success rates at times. You should gracefully handle failed refreshes and not attempt to retry them for 15 minutes.

Quota

Each newly queued item consumes one call from your daily API quota. If an item is ineligible or has already been queued, it will not consume any quota to call the API again and check its status.

If a queued refresh fails, its credit is refunded automatically, and the item sits out a short cooldown (about 15 minutes) before it can be queued and charged again. Separately from the quota, raw calls to this endpoint are capped at 2,000 per hour per user.