# API: List promotion codes

# listPromoCodes

A list of available promotion codes

TIP

This API call uses pagination for results.

# Optional parameters

Parameter Description
page Which page to return (default:0)
include_batch When set to 1 results will also include coupons related to batches, which are not listed by default

# Request

GET /admin/api.php?api_id=API_ID&api_key=API_KEY&call=listPromoCodes

# PHP Samples

# Response

{
    "success": true,
    "coupons": [
        {
            "id": "9",
            "code": "MN634HMI7L6B",
            "status": "Active",
            "coupon_type": "cart",
            "type": "percent",
            "value": "11.000",
            "num_usage": "0",
            "notes": ""
        },
        {
            "id": "3",
            "code": "6TO0CDNM1",
            "status": "Active",
            "coupon_type": "cart",
            "type": "percent",
            "value": "3.000",
            "num_usage": "0",
            "notes": ""
        },
        {
            "id": "1",
            "code": "MN634HMI7L6B",
            "status": "Active",
            "coupon_type": "cart",
            "type": "percent",
            "value": "11.000",
            "num_usage": "0",
            "notes": ""
        }
    ],
    "call": "listPromoCodes",
    "sorter": {
        "perpage": 25,
        "totalpages": 1,
        "sorterrecords": "3",
        "sorterpage": 1
    },
    "server_time": 1611584941
}
Last Updated: 9/4/2023, 2:34:55 PM