> For the complete documentation index, see [llms.txt](https://p00ls.gitbook.io/token-os/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://p00ls.gitbook.io/token-os/management-api/campaigns.md).

# Campaigns

Campaigns are how your users can earn your $TOKEN in exchange for completing an action, or as we refer to them - incentive.  Once a campaign is active, users can complete one or more incentives and earn your $TOKEN as a reward.  

For more details, read our guide on [rewarding your audience in exchange for completing an incentive](/token-os/guides/rewarding-your-audience/in-exchange-for-completing-an-incentive.md).

### The campaign object

This object represents a campaign.  It lets you retrieve basic information about the campaign including supply remaining, status, start and end dates, and total number of participating users.

### Retrieve campaign

{% openapi src="/files/0xcSTZfwttgKwkRT0eAS" path="/campaigns/{campaignId}" method="get" %}
[creator-api.yaml](https://2025772754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKOyoBDhx8ymvd9xgu92d%2Fuploads%2FV9K5lc6vyEJK4GH14sh4%2Fcreator-api.yaml?alt=media\&token=9ea3d663-0606-4b83-a29c-d9fd58940b29)
{% endopenapi %}