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
}
}