Transfer a whole series to another reseller

POST /api/v1/card-batches/{id}/transfer-whole prm_cards_change_owner

Moves every card in the series from one manager to another at an agreed unit price, posting the matching ledger entries on both sides.

unit_price is a required tri-state and omitting it is refused rather than read as zero. A bare 0 from a client that simply left the field out would mean "give the stock away", which is exactly the defect this check exists to stop. A negative price inverts the transfer.

At a glance

Authentication: Staff token or session
Requires permission: prm_cards_change_owner Transfer / change card owner
Rate limit: t_mutate
Idempotency key: request_id

Parameters

Parameter	Description
`id`required path · integer	Series id.
`from_manager_id`required body · integer	The current holder.
`to_manager_id`required body · integer	The receiving reseller.
`unit_price`required body · number	Price per card, major units. Must be sent explicitly — omitting it is an error, not a zero.
`request_id`required body · string	Idempotency key.

Errors

Code	When it is returned
`ERR_VALIDATION`400	unit_price omitted, or a request_id that is missing, too long or reserved
`ERR_CONFLICT`409	the request_id is already bound to a different transfer

Request

curl -X POST "$BASE/api/v1/card-batches/{id}/transfer-whole" \
  -H "Authorization: Bearer $XR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "from_manager_id": 41,
  "to_manager_id": 57,
  "unit_price": 140.00,
  "request_id": "c8e1a4b9-7f30-4d62-b0a5-6e2c9d3f1074"
}'

BASE is your tenant host: the same address you sign in on.

Try it on your own network.

50 subscribers for 7 days. You pay nothing.

Try it free Talk to us