🚀 New: Edit Shoppex themes from the dashboard, the CLI, or an AI agent — one unified workflow. Learn more →
curl --request POST \
--url https://api.shoppex.io/dev/v1/products/{id}/serials/claim \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"amount": 2
}'{
"data": {
"claimed_count": 2,
"remaining_stock": 7,
"serials": [
{
"id": "serial_1",
"serial": "ABC-123",
"variant_id": null,
"variant_title": null,
"created_at": "2026-03-16T10:00:00.000Z"
},
{
"id": "serial_2",
"serial": "XYZ-789",
"variant_id": null,
"variant_title": null,
"created_at": "2026-03-16T10:01:00.000Z"
}
]
}
}Atomically claims and removes the requested number of available serials from a base serial product without variants, then returns the claimed serial values plus the updated remaining stock.
curl --request POST \
--url https://api.shoppex.io/dev/v1/products/{id}/serials/claim \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"amount": 2
}'{
"data": {
"claimed_count": 2,
"remaining_stock": 7,
"serials": [
{
"id": "serial_1",
"serial": "ABC-123",
"variant_id": null,
"variant_title": null,
"created_at": "2026-03-16T10:00:00.000Z"
},
{
"id": "serial_2",
"serial": "XYZ-789",
"variant_id": null,
"variant_title": null,
"created_at": "2026-03-16T10:01:00.000Z"
}
]
}
}Use your Shoppex API key in the Authorization header.
1 <= x <= 500Successful response