Get Single Item

GET 
/api/TagReservations/reservebysku/:skuId/:quantity

Tier: Public — stable, supported for third-party integration.

Reserves {quantity} tag numbers for a SKU, drawn from its GS1 numbering register under a per-organisation allocation lock. Despite the method name, this reserves a batch, not a single item.

Request

Responses

200

Returns a TagReservationDtos.TagReservationDto with the allocated tag numbers.

400

Unknown SKU (NotFound); the SKU is not operational — Draft or Discontinued (InvalidOperation); the SKU's encoding type is unsupported (OperationFailed "SkuEncodingType"); or an allocator failure — error array.

401

Caller is not authenticated.

403

Caller lacks LocafiModule.Tag Create.