Skip to content

Refund a bundle usage

POST
/inventory/refund

Refunds an item in the inventory to the organisations balance.

Takes a usageId and a quantity. The usageId’s can be found by querying the /inventory endpoint

The quantity of a refund cannot exceed the remaining quantity left for the specific usageId. If you wish to refund multiple usageId’s, multiple calls to this endpoint will need to be done.

If a bundle assignment has not been started and no data has been consumed, the bundle can be refunded as a credit back to the organisations balance.

If the bundle assignment has started, or was purchased outside of their permitted refund period, typically 60 days, it cannot be refunded.

Request Body required

Input data for refund

object
usageId

The usage id for the refund

integer
quantity

The quantity of the refund

integer

Responses

200

Successfully refunded bundles

object
message

Status of api functions which do not return data

string

400

Bad Request - returned when request format is not accepted

object
message

Status of api functions which do not return data

string

403

Unauthorised - returned when the api token is invalid; the user does not have any available Bundles left or the eSIM is not accessible by the user

object
message

Status of api functions which do not return data

string

500

Server Error

object
message

Status of api functions which do not return data

string