v2
latestOpenAPI 3.1.02026-08-01244220427.0 KBGift Cards
Poll async bulk issuance task
Poll Async Bulk Issuance
Returns the current status of an async bulk gift-card issuance task.
Path Parameters:
- programId: MongoDB ObjectId of the loyalty program
- taskId: Celery task ID returned by the bulk issuance POST
Response (BulkIssuanceTaskStatus):
- status: "pending" | "processing" | "completed" | "failed"
- issuedCount, cards, csvDownloadUrl — populated when status == "completed"
- failedCount, error — populated when status == "failed" or on partial failure
get/v2/giftcards/programs/{programId}/cards/bulk/{taskId}
Path parameters
taskIdstring required
programIdstring required
Example:5eb7cf5a86d9755df3a6c593
Query parameters
cardIdstring
Example:5eb7cf5a86d9755df3a6c593
Headers
X-Eposn-Customer-Tokenstring nullable
X-Eposn-Merchant-Tokenstring nullable
Response
Successful Response