Airalo Developer Platform
  1. Notification: Credit limit
Airalo Developer Platform
  • OVERVIEW
    • Introduction
    • Attribute descriptions
    • FAQ
    • Quick start
      • Step 1: Request access token
      • Step 2: Get packages
      • Step 3: Submit order
      • Step 4: Get installation instructions
    • User journeys
      • Purchase journey
      • Top-up journey
    • Guides
      • How to set up a brand for eSIMs Cloud link sharing
      • How to get the eSIMs Cloud sharing link through API
      • How to generate the QR code for an eSIM
      • eSIM installation methods for API Partners
  • REST API
    • Introduction
    • Rate limits
    • Error handling
    • Endpoints
      • Authenticate
        • Request access token
      • Browse packages
        • Get packages
      • Place order
        • Submit order
        • Submit order async
        • Future orders
        • eSIM voucher
      • Install eSIM
        • Get eSIM
        • Get installation instructions
      • Monitor usage
        • Get usage (data, text & voice)
      • Place top up order
        • Submit top-up order
        • Get top-up package list
        • Get eSIMs list
        • Get eSIM package history
      • Manage orders & eSIMs
        • Get order list
        • Cancel future orders
        • Get order
        • Update eSIM brand
      • Compatible devices
        • [Deprecated] Get compatible device list
        • Get compatible device lite list
      • Notifications
        • Understanding webhooks: Asynchronous communication for modern applications
        • Webhook definition
        • Airalo webhooks opt-in and flow
        • Notification: Low data
          • Opt in
          • Get notification details
          • Opt out
        • Notification: Credit limit
          • Opt in
            POST
          • Get notification details
            GET
          • Opt out
            POST
        • Notification: Async orders
          • Opt in
          • Get notification details
          • Opt out
        • Webhook simulator
          POST
      • Check balance
        • Get balance
      • Refunds
        • Refund request
    • Guides
      • Step #1 - Authentication
  • SDKs
    • Introduction
    • SDK vs. REST API
    • Technical notes
  • WOOCOMMERCE PLUGIN
    • Introduction
    • Guides
      • How to install the Airalo Plugin for WooCommerce
      • How to set up prices in WooCommerce
      • How to customize the "My eSIMs" page colors in WooCommerce
      • How to convert prices into your local currency
      • How to finalize your WooCommerce shop setup
      • How to test in sandbox mode
      • How to go live
      • How to customize WooCommerce email templates for eSIM sales
  • SHOPIFY APP
    • Introduction
    • Guides
      • How to install the Airalo Shopify App
      • How to set up prices in Shopify
  1. Notification: Credit limit

Opt in

POST
/v2/notifications/opt-in
Receive notifications regarding your credit limit as it reaches specific thresholds. You have
the flexibility to opt-in for various levels based on your requirements. For instance, you can
choose to receive notifications at 90% of your credit limit or select multiple thresholds such
as 50%, 70%, and 90%. These notifications can be delivered either to your webhook or your
company email address.
Parameters
type (required)
"webhook_credit_limit": use this value to receive notification via webhook.
"email_credit_limit": use this value to receive notification via email.
If type provided is "webhook_credit_limit":
webhook_url (required): provide the URL of your Webhook implementation. Example: "https://example.com".
If type provided is "email_credit_limit":
email (required): provide the email address to recieve the email notifications.
language(optional): language for the email based notifications. Example: “en”.
levels (optional): Credit limit thresholds at which notifications are triggered.
Must be a subset of: [50, 70, 80, 90].
Example: [70, 90] — notifications will be sent when usage exceeds 70% and 90%.
For more information and best practices, visit our FAQ page..
You can provide your email address using the email parameter, which will send an email to your inbox asynchronously.
Below is a sample of the email notification.

Request

Header Params

Body Params application/json

Example
{
    "type": "webhook_credit_limit",
    "webhook_url": "https://example.com",
    "levels": [
        50,
        70,
        80,
        90
    ]
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/v2/notifications/opt-in' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "webhook_credit_limit",
    "webhook_url": "https://example.com",
    "levels": [
        50,
        70,
        80,
        90
    ]
}'

Responses

🟢200Get the webhook based notification
text/plain
Body

Example
{
    "data": {
        "notification": {
            "type": "webhook_credit_limit",
            "contact_point": "https://example.com",
            "levels": [
                50,
                70,
                80,
                90
            ]
        }
    },
    "meta": {
        "message": "success"
    }
}
🟢200Receive notification via email
Modified at 2025-08-19 11:05:31
Previous
Opt out
Next
Get notification details
Built with