> ## Documentation Index
> Fetch the complete documentation index at: https://help.lobyco.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Challenges

> Surfacing challenges in your own mobile or web front end.

## Get Challenges

Challenges differ from offers in that they represent rules users must fulfill to earn rewards. Rewards can include:

* Discount coupons
* Bonus points
* Lottery tickets

Challenges require distinct app UI that clearly communicates the rules and user progress, as challenges can accumulate progress across multiple purchases.

Use [GET challenge/v3/cards](/api-reference/promotion-platform/challenges/get-v3-cards) to retrieve all available challenges for a user. Similar to offers, we recommend displaying:

* A **minimalistic challenge card** highlighting status, progress, and high-level reward information
* A **detailed challenge page** containing complete data and terms & conditions

Refer to the API documentation for complete challenge data specifications.

## Activation

Challenges support both `pre-activated` and activation-required modes. Display the corresponding status on the challenge card. For challenges requiring activation to begin progress accumulation, include an activation button that calls [PUT challenge/v3/cards/(id)/activate](/api-reference/promotion-platform/challenges/put-v3-cards-id-activate).

Once activated, challenges cannot be deactivated, and users can progress toward completion during subsequent store visits.

## Recommendations

We recommend you to not make Challenges as `pre-activated` to avoid users completing Challenge without even knowing about them. Instead, make them activate one manually for it to be a concise decision potentially affecting their shopping behaviour.

Also, a challenge can be toggled to `Hide Challenge from App List`. Such a challenge will not be returned to the app but it's possible collect such Challenge without progress and status being shown in the app. This is useful in case such Challenge is promoted using different sources or you would like to have some custom configurable behaviour like a spending Challenge triggering a custom event on completion.

Same as with Offers, it's important to pick a good enough image for a challenge to indicate the reward or rules specifics. You can have a look on our White label reference

<img src="https://mintcdn.com/lobyco-4c9fb3ad/wpdZgjvGMgh4Gbhy/images/1ad095a5ad4179311d6f77c3fd8f823cf0d38f6f.png?fit=max&auto=format&n=wpdZgjvGMgh4Gbhy&q=85&s=621a87442b056b056b034611881287be" alt="" width="702" height="472" data-path="images/1ad095a5ad4179311d6f77c3fd8f823cf0d38f6f.png" />
