Flight Alert API

Refill web-hook subscription balance / TIER 1

Performs refill operation on the web-hook subscription balance by the specified amount of credits. This balance is separate from your API marketplace quota and is used solely for billing of web-hook subscriptions.

In the request body, you specify how many credits you want to add. This is a variable-rate endpoint and the amount of API units deducted from your API quota depends on the amount of flight alerts credits requested. The conversion rate is: 1 credit = 1 API unit.

Additional limits apply with regard to how many credits you can request per single refill operation and how many credits you can have in your balance at any given time. These limits depend on your pricing plan (https://aerodatabox.com/pricing).

For more details about how flight alert API billing works, refer to our guide at https://aerodatabox.com/flight-alert-api-2026/

post/subscriptions/balance/refill

Request

  • Base URL: https://api.aerodatabox.com
  • URL: https://api.aerodatabox.com/subscriptions/balance/refill
  • Auth: API key in header X-Api-Key

Request body

creditsinteger required

Number of credits to add to the notification subscription balance.

Response

OK

creditsRemaininginteger required

Alert credits remaining for the account.

lastRefilledUtcstring date-time required

The datetime when the balance was last re-filled, in UTC.

lastDeductedUtcstring date-time required

The datetime when the balance was last deducated, in UTC. Deduction typically occurs when an alert notification was dispatched for one of the alert subscriptions associated with the user account.

Changes

No recorded changes to this operation across all 1 revision of this API.