Time	Status	User Agent
Retrieving recent requests…

Using this API, you can issue multiple coupons from a coupon series to the same customer by defining the quantity of coupons.

👍
Note

For detailed information about our APIs and for hands-on testing, refer documentation in API overview and step-by-step guide on making your first API call in Make your first API call .

Prerequisites

Authentication: Basic or OAuth authentication
Default access group

Resource information


URI	/v2/coupon/issue/multiple
HTTP method	POST
Pagination	NA
Batch support	Yes

API endpoint example

https://eu.api.capillarytech.com/v2/coupon/issue/multiple

Request body parameters

Parameter	Datatype	Required	Description
seriesIds*	Integer	Yes	Series ID of coupon. You can get the Series ID from this API. Externally managed/third party coupons are not supported.
count*	Integer	Yes	Number of coupons to be issued from the series. NOTE: Maximum coupons that can be issued is 500. If the count is not specified, by default it will take 1.
customer*	Object	Yes	The object containing the details of the customer. You can use mobile, email or external id of the customer.
metadata	Object	Optional	Defines tracking and auditing information for the coupon issuance.
..sourceType	String	Optional	Specifies the category of the source initiating the issuance (e.g., Journeys, Promotions, POS, API). Supports alphanumeric characters, spaces, and special characters up to a maximum length of 50.
..sourceId	String	Optional	Indicates the unique reference ID of the source entity (e.g., Journey block ID, rule name, external workflow ID). Supports alphanumeric characters, spaces, and special characters up to a maximum length of 50.
..sourceActivity	String	Optional	Indicates the specific event or activity that triggered the issuance (e.g., Tier upgrade, Milestone completion). Supports alphanumeric characters, spaces, and special characters up to a maximum length of 50.
..notes	String	Optional	Specifies additional comments or operational notes regarding the issuance (e.g., issued as part of a migration batch). Supports alphanumeric characters, spaces, and special characters up to a maximum length of 250.
..reason	String	Optional	Specifies the business justification for issuing the coupons (e.g., tier upgrade benefit, service recovery). Supports alphanumeric characters, spaces, and special characters up to a maximum length of 250.

{
    "seriesId": 415446,
    "count": 2,
    "customer": {
        "mobile": "11223569865"
    }
}

{
    "seriesId": 415446,
    "count": 2,
    "customer": {
        "email": "[email protected]"
    }
}

{
    "seriesId": 18426,
    "count": 2,
    "customer": {
        "externalId": "3873472"
    }
}

Response parameters

Parameters	Description
coupons	List of coupons issued.
coupons.code	Code of the coupon.
coupons.couponId	ID of the coupon.
couponConfig	Configuration details of the coupon.
couponConfig.customPropertyMap	Custom properties of the coupon.
couponConfig.id	ID of the coupon configuration.
couponConfig.description	Description of the coupon configuration.
couponConfig.discountCode	Discount code associated with the coupon.
couponConfig.info	Information about the coupon configuration.
couponConfig.discountUpto	Maximum discount value.
couponConfig.discountValue	Value of the discount.
couponConfig.issueToLoyalty	Indicates if the coupon is issued to a loyalty program.
couponConfig.numUploadedNonIssued	Number of non-issued uploaded coupons.
couponConfig.numUploadedTotal	Total number of uploaded coupons.
couponConfig.redemptionValidAfterDays	Days after which the coupon is valid for redemption.
couponConfig.ownerId	ID of the coupon owner.
couponConfig.ownerValidity	Validity period of the coupon owner.
couponConfig.alphaNumeric	Indicates if the coupon code is alphanumeric.
couponConfig.shortCodeLength	Length of the short code.
couponConfig.randomCodeLength	Length of the random code.
couponConfig.fixedExpiryDate	Fixed expiry date of the coupon.
couponConfig.numTotal	Total number of coupons.
couponConfig.latestIssualTime	Timestamp of the latest coupon issuance.
couponConfig.latestRedemptionTime	Timestamp of the latest coupon redemption.
couponConfig.discountOn	Indicates what the discount applies to (e.g., BILL).
couponConfig.discountType	Type of discount.
couponConfig.externalIssual	Indicates if the coupon is issued externally.
couponConfig.updateProductData	Indicates if product data is updated.
customer	Customer details.
customer.id	ID of the customer.
totalCount	The total number of coupons that were attempted to be issued
failureCount	The number of coupons that failed to be issued
successCount	The number of coupons that were successfully issued
customer.profiles.lastName	Last name of the customer.
customer.profiles.fields	Custom fields of the customer profile.
customer.profiles.allFields	All fields of the customer profile.
customer.profiles.identifiers	List of customer identifiers.
customer.profiles.identifiers.type	Type of the identifier (e.g., email, mobile, external id.etc).
customer.profiles.identifiers.value	Value of the identifier.
customer.profiles.commChannels	Communication channels of the customer.
customer.profiles.userId	User ID associated with the customer profile.
customer.profiles.accountId	Account ID associated with the customer profile.
customer.profiles.autoUpdateTime	Timestamp of the last auto-update of the customer profile in ISO 8601 format, returned in the server time zone. EU server example: `2025-10-09T06:45:52Z` → 09 October 2025, 06:45:52 (UTC). India server example: `2025-10-09T12:15:52+05:30` → 09 October 2025, 12:15:52 (IST). Note: The response time zone always matches the server time zone, regardless of the time zone offset in the request.
customer.profiles.identifiersAll	List of all identifiers of the customer profile.
customer.profiles.identifiersAll.type	Type of the identifier (e.g., email, mobile, external id).
customer.profiles.identifiersAll.value	Value of the identifier.
errors	List of errors.
warnings	List of warnings.

{
    "coupons": [
        {
            "code": "3084294818",
            "couponId": 1237263304
        },
        {
            "code": "5686061236",
            "couponId": 1237263305
        }
    ],
    "couponConfig": {
        "customPropertyMap": {},
        "id": 0,
        "description": "IKEA - 500KW Voucher ",
        "discountCode": "NO_VALUE",
        "info": "IKEA - 500KW Voucher ",
        "discountUpto": 0,
        "discountValue": 500,
        "issueToLoyalty": false,
        "numUploadedNonIssued": 0,
        "numUploadedTotal": 0,
        "redemptionValidAfterDays": 0,
        "ownerId": 0,
        "ownerValidity": 0,
        "alphaNumeric": false,
        "shortCodeLength": 0,
        "randomCodeLength": 0,
        "fixedExpiryDate": 0,
        "numTotal": 0,
        "latestIssualTime": 0,
        "latestRedemptionTime": 0,
        "discountOn": "BILL",
        "discountType": "ABS",
        "externalIssual": false,
        "updateProductData": false
    },
    "totalCount": 2,
    "failureCount": 0,
    "successCount": 2,
    "customer": {
        "id": 555567088,
        "profiles": [
            {
                "firstName": "Abijith",
                "lastName": "Gupta",
                "fields": {},
                "allFields": {},
                "identifiers": [
                    {
                        "type": "mobile",
                        "value": "11223569865"
                    },
                    {
                        "type": "externalId",
                        "value": "000003873472"
                    }
                ],
                "commChannels": [],
                "userId": 555567088,
                "accountId": "",
                "autoUpdateTime": "2024-08-20T09:57:15Z",
                "identifiersAll": [
                    {
                        "type": "mobile",
                        "value": "11223569865"
                    },
                    {
                        "type": "externalId",
                        "value": "000003873472"
                    }
                ]
            }
        ]
    },
    "errors": [],
    "warnings": []
}

{
    "coupons": [
        {
            "code": "DECATH10",
            "couponId": 1239821361
        }
    ],
    "couponConfig": {
        "customPropertyMap": {},
        "id": 0,
        "description": "10% off Decathlon Products",
        "discountCode": "NO_VALUE",
        "info": "10% off Decathlon Prodcuts",
        "discountUpto": 0,
        "discountValue": 100,
        "issueToLoyalty": false,
        "numUploadedNonIssued": 0,
        "numUploadedTotal": 0,
        "redemptionValidAfterDays": 0,
        "ownerId": 0,
        "ownerValidity": 0,
        "alphaNumeric": false,
        "shortCodeLength": 0,
        "randomCodeLength": 0,
        "fixedExpiryDate": 0,
        "numTotal": 0,
        "latestIssualTime": 0,
        "latestRedemptionTime": 0,
        "discountOn": "BILL",
        "discountType": "ABS",
        "externalIssual": false,
        "updateProductData": false
    },
    "totalCount": 1,
    "failureCount": 0,
    "successCount": 1,
    "customer": {
        "id": 555567088,
        "profiles": [
            {
                "firstName": "Abijith",
                "lastName": "Gupta",
                "fields": {},
                "allFields": {},
                "identifiers": [
                    {
                        "type": "mobile",
                        "value": "11223569865"
                    },
                    {
                        "type": "externalId",
                        "value": "000003873472"
                    }
                ],
                "commChannels": [],
                "userId": 555567088,
                "accountId": "",
                "autoUpdateTime": "2024-09-03T10:13:55Z",
                "identifiersAll": [
                    {
                        "type": "mobile",
                        "value": "11223569865"
                    },
                    {
                        "type": "externalId",
                        "value": "000003873472"
                    }
                ]
            }
        ]
    },
    "errors": [],
    "warnings": []
}

{
    "errors": [
        {
            "status": false,
            "code": 707,
            "message": "Coupon Series ID is invalid"
        }
    ]
}

{
    "errors": [
        {
            "status": false,
            "code": 677,
            "message": "Invalid coupon count. Minimum 1 and Maximum 500."
        }
    ]
}

{
    "errors": [
        {
            "status": false,
            "code": 701,
            "message": "The customer could not be found. Please check mobile, email, external id passed"
        }
    ]
}

{
    "coupons": [
        {
            "code": "2YQWCWQXZ6NTMTAJLCXNP1T6CYMN",
            "couponId": 96004050
        }
    ],
    "couponConfig": {
        "customPropertyMap": {},
        "id": 0,
        "description": "Only 1 issual",
        "discountCode": "NO_VALUE",
        "info": "Only 1 issual",
        "discountUpto": 0,
        "discountValue": 1,
        "issueToLoyalty": false,
        "numUploadedNonIssued": 0,
        "numUploadedTotal": 0,
        "redemptionValidAfterDays": 0,
        "ownerId": 0,
        "ownerValidity": 0,
        "alphaNumeric": false,
        "shortCodeLength": 0,
        "randomCodeLength": 0,
        "fixedExpiryDate": 0,
        "numTotal": 0,
        "latestIssualTime": 0,
        "latestRedemptionTime": 0,
        "discountOn": "BILL",
        "discountType": "ABS",
        "updateProductData": false,
        "externalIssual": false
    },
    "totalCount": 2,
    "failureCount": 1,
    "successCount": 1,
    "customer": {
        "id": 374658850,
        "profiles": [
            {
                "firstName": "plerthprth",
                "lastName": "gmmlzilbpg",
                "fields": {},
                "allFields": {},
                "identifiers": [
                    {
                        "type": "email",
                        "value": "[email protected]"
                    },
                    {
                        "type": "mobile",
                        "value": "918028464628"
                    },
                    {
                        "type": "externalId",
                        "value": "x918028464628"
                    }
                ],
                "commChannels": [],
                "userId": 374658850,
                "accountId": "",
                "autoUpdateTime": "2024-08-01T12:42:46+05:30",
                "identifiersAll": [
                    {
                        "type": "email",
                        "value": "[email protected]"
                    },
                    {
                        "type": "mobile",
                        "value": "918028464628"
                    },
                    {
                        "type": "externalId",
                        "value": "x918028464628"
                    }
                ]
            }
        ]
    },
    "errors": [
        {
            "status": false,
            "code": 5004,
            "message": "Issue only one coupon. Since isAllowMultipleVouchersPerUser=false."
        }
    ],
    "warnings": []
}

{
    "errors": [
        {
            "status": false,
            "message": "Coupon has expired",
            "code": 713
        }
    ]
}

{
    "errors": [
        {
            "status": false,
            "message": "Coupon processing failed: user already has a coupon",
            "code": 709
        }
    ]
}

{
    "errors": [
        {
            "status": false,
            "code": 756,
            "message": "seriesId is mandatory to set"
        }
    ]
}

    "errors": [
        {
            "status": false,
            "code": 5004,
            "message": "Cannot issue more than one GENERIC coupon code."
        }
    ],
    "warnings": []
}

{
    "errors": [
        {
            "status": false,
            "code": 756,
            "message": "count should be greater than 0"
        }
    ]
}

{
    "seriesId": [415446,535521],
    "count": 2,
    "customer": {
        "mobile": "11223569865"
    }
}
//This is a part of request body.

    "errors": [
        {
            "status": false,
            "code": 5002,
            "message": "max coupon per user exceeded"
        }
    ],
    "warnings": []
}

API-specific error and warning codes

Warning Error Code (Partial Success*)	Error code	Description
	701	The customer could not be found. Check if mobile, email, external id entered correctly.
	707	Coupon Series ID is invalid.
	709	Coupon processing failed as user already has a coupon.
	713	Coupon has expired.
	756	SeriesId is mandatory.
679	5004	Cannot issue more than one GENERIC coupon code or Issue only one coupon. This error occurs when the Maximum issuals per customer is set to 1.
626	5001	Maximum number of series has been created.
621	5002	Maximum number of coupon issued per user has been exceeded
702	5005	Queue is empty for series. This error happens on the backend because of system caching issues.
678	5006	Unable to issue certain number of coupons

*****Partial Success - This occurs when only some coupons are issued, while the rest are not issued due to certain reasons.

Coupon Series Exhaustion

When all coupons in a coupon series have been issued (for example, after all manually uploaded coupons are distributed), the system enforces a fixed limit and prevents any further coupon issuance or redemption attempts from that series. If a redemption or issuance is attempted after the series is exhausted, the request will fail, and an appropriate error message will be returned. To continue issuing coupons, you must upload additional coupons to the series or create a new coupon series.

Note: Always ensure that your coupon series contains enough coupons to fulfill expected issuance or redemption volumes. Monitor the available coupon count in each series to avoid unexpected failures due to series exhaustion.

Note

Prerequisites

Resource information

API endpoint example

Request body parameters

Response parameters

API-specific error and warning codes

Coupon Series Exhaustion

200200

400400