Fetch Customer Alert Requests

We provide a storefront API endpoint to fetch all alert requests for a customer. This can be useful if you wish to build a management portal in the customer account area.

Fetch Alert Requests

Endpoint

GET https://backinstockalerts.space48apps.com/api/stores/{store_hash}/customers/{jwt}/alert-requests        

Path Parameters

Query Params

Headers

Response Body

AlertRequest

Product

Notification

Meta

Example Response

{
    "data": [
        {
            "id": 483,
            "channel_id": 1,
            "created_at": "2025-11-20 10:30:06",
            "product": {
                "product_id": 11135,
                "product_variant_id": 23303,
                "name": "Organic Slug Stop Pellet Barrier Pouch",
                "sku": "430174",
                "url": "https:\/\/space48-tom.mybigcommerce.com\/products\/organic-slug-stop-pellet-barrier-pouch",
                "image_url": "https:\/\/backinstockalerts.space48apps.com\/img\/ProductDefault.gif",
                "price": "8.95\u00a3"
            },
            "notification": null,
            "unsubscribed": "2025-11-20 10:30:37"
        },
        {
            "id": 482,
            "channel_id": 1,
            "created_at": "2025-11-20 10:26:42",
            "product": {
                "product_id": 86,
                "product_variant_id": null,
                "name": "[Sample] Able Brewing System",
                "sku": "ABS",
                "url": "https:\/\/space48-tom.mybigcommerce.com\/able-brewing-system",
                "image_url": "https:\/\/cdn11.bigcommerce.com\/s-7zh8t3rjik\/products\/86\/images\/286\/ablebrewingsystem4.1566917391.386.513.jpg?c=1",
                "price": "225.00\u00a3"
            },
            "notification": null,
            "unsubscribed": null
        }
    ],
    "meta": {
        "total": 2,
        "count": 2,
        "per_page": 25,
        "current_page": 1,
        "total_pages": 1
    }
}

Sample Code

Fetching a Current Customer JWT

The first step before making a request to the Back in Stock Alerts API for this endpoint is to request a JWT from BigCommerce to identify the currently logged-in customer using the Current Customer API.

const app_client_id = '9s57chpu0tik4pw7wz9d2p022qnff6n'; // Back in Stock Alerts Client ID

const fetchCustomerJWT = async (app_client_id) => {

    const response = await fetch(
        '/customer/current.jwt?app_client_id=' + app_client_id
    );

    if (!response.ok) {
        if (response.status === 404) {
            return new Error('Customer not logged in.');
        }

        return new Error('Unable to identify customer');
    }

    return await response.text();
}

const jwt = await fetchCustomerJWT(app_client_id);

Then, you can use this JWT to fetch all alert requests for this customer:

const fetchAlertRequests = async (store_hash, jwt, filters = {}) => {
    // Build query string from filters
    const params = new URLSearchParams(filters).toString();
    const url = "https://backinstockalerts.space48apps.com/api/stores/" + store_hash + "/customers/" + jwt + "/alert-requests" + (params ? "?" + params : "");

    const response = await fetch(url, {
        headers: { Accept: "application/json" },
    });

    if (!response.ok) {
        if (response.status === 404) {
            return new Error(response?.data?.error || "Sorry, no alert requests found.");
        } else if (response.status === 402) {
            return new Error(response?.data?.error || "A subscription to Back in Stock Alerts is required to perform this action.");
        }
        return new Error("Unable to fetch alert requests.");
    }

    return await response.json();
};

// Example usage
const store_hash = "nqivp06qsb"; // Change for your store 
const app_client_id = "9s57chpu0tik4pw7wz9d2p022qnff6n"; // Back in Stock Alerts
const jwt = await fetchCustomerJWT(app_client_id);

const alerts = await fetchAlertRequests(store_hash, jwt, {
    page: 1,
    per_page: 20,
    status: "pending", // optional filter
});