Get

[POST] .../v1/promobonus/get

Gets list bonuses promotions. Use this method to retrieve one customer card bonus operation by uuid for diagnostics or to inspect an operation created by the PromoBonus workflow. The request requires uuid and the promo bonus operations permission; it can be narrowed by filters. The response returns the matching RetailCardOperation object when it exists, including type, amount, value, used_value, payment flag, operation date, expiry date, description and last_update. Business errors such as a missing request body, missing uuid, denied access, invalid filters, database errors or persistent operation lookup failures are returned as HTTP 200 ErrorResult.

Request Parameters

Name Type Required Description
filters Array of Filter Optional Optional filters by fields available for this API method.

Filterable Fields

Field Type Description
uuid string Customer card bonus operation UUID.

Request Example

{
  "filters": [
    {
      "Field": "uuid",
      "Operator": "Equal",
      "Value": "string"
    }
  ]
}

Response Parameters

Name Type Description
ok Boolean Indicates whether the request completed successfully.
result RetailCardOperation Result object.

Response Example

{
  "ok": true,
  "result": {
    "amount": 1.0,
    "card_id": 1,
    "date": 1,
    "description": "string",
    "exp_date": 1,
    "is_payment": true,
    "last_update": 1,
    "type": "Income",
    "used_value": 1.0,
    "uuid": "00000000-0000-0000-0000-000000000000",
    "value": 1.0
  }
}