8. Active Campaigns

You can list your active campaigns using the relevant service

List Active Campaigns

GET{{WalletUrl}}/api/v1/campaign/active

Note: To use this service, the apikeypublic and apiclientpublic parameters must be included in the Header field.

WalletAPI Address

The parameters that need to be sent to the service are as follows:

Parameter	Type	Required	Description
apikeypublic	string	Yes	It is the authentication key used to provide general API access.
apiclientpublic	string	Yes	It is the public identification key that defines the client application.

Service Reguest - JSON

{
    "Items": [
        {
            "Id": "3ff9d71a-70cc-4be1-80bd-5db35fdb9e70",
            "Name": "fırsat101",
            "Description": "<string>",
            "MinimumDepositAmount": 500.00,
            "MaximumDepositAmount": 2000.00,
            "BonusType": "Fixed",
            "BonusValue": 1.00,
            "CampaignType": "Bonus",
            "StartDate": "2025-06-26",
            "EndDate": "2025-06-28",
            "IsActive": true,
            "MerchantId": 2071,
            "TotalBonusGiven": 0.00,
            "CreatedAt": "2025-05-01T14:14:05.151023Z",
            "UpdatedAt": null
        },
        {
            "Id": "17c87eeb-3e20-4f70-a1d8-cc801007d550",
            "Name": "fırsat100",
            "Description": "<string>",
            "MinimumDepositAmount": 500.00,
            "MaximumDepositAmount": 2000.00,
            "BonusType": "Fixed",
            "BonusValue": 1.00,
            "CampaignType": "CashBack",
            "StartDate": "2025-06-26",
            "EndDate": "2025-06-28",
            "IsActive": true,
            "MerchantId": 2071,
            "TotalBonusGiven": 0.00,
            "CreatedAt": "2025-05-01T14:13:42.169338Z",
            "UpdatedAt": null
        }
    ],
    "PageNumber": 1,
    "TotalPages": 1,
    "TotalCount": 2,
    "HasPreviousPage": false,
    "HasNextPage": false,
    "Errors": [],
    "IsSuccess": true,
    "IsFailure": false
}

Service Response

Parameter	Type	Description
IsFailure	bool	Indicates that an error occurred during the operation. If true, an error exists.
IsSuccess	bool	Indicates that the operation was successfully completed.
Errors	Array	A list containing error messages that occurred during the service call.
Items	Array	Contains the content information returned if the service is successful.

Service Response (Items)

Parameter	Type	Description
Id	Guid	It is the unique identifier generated by the system for the campaign.
Name	string	It is the defined name information of the campaign on the system.
Description	string	It is a descriptive text that provides information about the campaign.
MinimumDepositAmount	decimal	It is the minimum deposit amount required for the campaign to be valid.
MaximumDepositAmount	decimal	It is the maximum deposit limit applicable to benefit from the campaign.
BonusType	string	Specifies the type of bonus (e.g., fixed amount, percentage).
BonusValue	decimal	The numeric value of the bonus within the specified campaign.
CampaignType	string	Indicates the category or usage type of the campaign.
StartDate	DateTime	The date when the campaign becomes active.
EndDate	DateTime	The date when the campaign expires.
IsActive	bool	The status value indicating whether the campaign is currently active or not.
MerchantId	Guid	The unique identifier of the business or seller defining the campaign.
TotalBonusGiven	decimal	The total bonus amount given so far through this campaign.
CreatedAt	DateTime	Represents the time when the record was created.
UpdatedAt	DateTime	Indicates the date when it was last updated.