---
title: "Get current revision version"
method: GET
path: "/v1/applications/{applicationId}/campaigns/{campaignId}/revisions/current"
tags: ["Campaigns"]
---

# Get current revision version

`GET /v1/applications/{applicationId}/campaigns/{campaignId}/revisions/current`

## Request

- Base URL: `https://yourbaseurl.talon.one`
- URL: `https://yourbaseurl.talon.one/v1/applications/{applicationId}/campaigns/{campaignId}/revisions/current`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/talon/apis/management-api/docs/v1/applications/:applicationId/campaigns/:campaignId/revisions/current/get.ts> (a function with typed inputs; its response is checked against the schema)

> [!note] Management API endpoints are **not** meant to be used in real-time integrations that directly serve your end users. Rate limit: 3 requests per second.

Get the current revision version for the given campaign.

**Note:** The [Campaign staging and revisions](https://docs.talon.one/docs/product/applications/manage-general-settings#campaign-staging-and-revisions) feature must be enabled for your Application.
For more information, see [Revise campaigns](https://docs.talon.one/docs/product/campaigns/revise-campaigns).

## Path parameters

- `applicationId` integer, required
- `campaignId` integer, required

## Response `200`

OK

- Revision
  - `id` integer, required: Unique ID for this entity. Not to be confused with the Integration ID, which is set by your integration layer and used in most endpoints.
  - `activateAt` string, date-time: Timestamp when the revision will be activated.
  - `accountId` integer, required: The ID of the account that owns this entity.
  - `applicationId` integer, required: The ID of the Application that owns this entity.
  - `campaignId` integer, required: The ID of the campaign that the revision was created from.
  - `created` string, date-time, required: Timestamp when the revision was created.
  - `createdBy` integer, required: The ID of the user who created this revision.
  - `activatedAt` string, date-time: Timestamp when this revision was activated.
  - `activatedBy` integer: The ID of the user who activated this revision.
  - `currentVersion` RevisionVersion
    - `id` integer, required: Unique ID for this entity. Not to be confused with the Integration ID, which is set by your integration layer and used in most endpoints.
    - `accountId` integer, required: The ID of the account that owns this entity.
    - `applicationId` integer, required: The ID of the Application that owns this entity.
    - `campaignId` integer, required: The ID of the campaign that the revision was created from.
    - `created` string, date-time, required: Timestamp when the revision was created.
    - `createdBy` integer, required: The ID of the user who created this revision.
    - `revisionId` integer, required: The ID of the revision.
    - `version` integer, required: Incrementing number representing how many revisions have been activated on this campaign. Starts from `0` for a new campaign.
    - `name` string: A user-facing name for this campaign.
    - `startTime` string, date-time, nullable: Timestamp when the campaign will become active.
    - `endTime` string, date-time, nullable: Timestamp when the campaign will become inactive.
    - `attributes` object: Arbitrary properties associated with this campaign.
    - `description` string, nullable: A detailed description of the campaign.
    - `activeRulesetId` integer, nullable: The ID of the ruleset this campaign will use.
    - `tags` string[]: A list of tags for the campaign.
    - `couponSettings` CodeGeneratorSettings
      - `validCharacters` string[], required: List of characters used to generate the random parts of a code.
      - `couponPattern` string, required: The pattern used to generate codes, such as coupon codes, referral codes, and loyalty cards. The character `#` is a placeholder and is replaced by a random character from the `validCharacters` set.
    - `referralSettings` CodeGeneratorSettings
      - `validCharacters` string[], required: List of characters used to generate the random parts of a code.
      - `couponPattern` string, required: The pattern used to generate codes, such as coupon codes, referral codes, and loyalty cards. The character `#` is a placeholder and is replaced by a random character from the `validCharacters` set.
    - `limits` LimitConfig[]: The set of limits that will operate for this campaign version.
      - `action` string, required: The limitable action to which this limit applies. For example: - `setDiscount` - `setDiscountEffect` - `redeemCoupon` - `createCoupon`
      - `limit` number, required: The value to set for the limit.
      - `period` 'daily' | 'weekly' | 'monthly' | 'yearly': The period on which the budget limit recurs.
      - `entities` string[], required: The entity that this limit applies to.
    - `reevaluateOnReturn` boolean: Indicates whether this campaign should be reevaluated when a customer returns an item.
    - `features` string[]: A list of features for the campaign.
    - `couponAttributes` object: Arbitrary properties associated with coupons in this campaign.

## Changes

- **2026-11-07** `7ef1b9504c3a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/talon/apis/management-api/changes/v1/applications/:applicationId/campaigns/:campaignId/revisions/current/get.md)

---

[API](https://skmtc.dev/talon/apis/management-api.md) - [All operations](https://skmtc.dev/talon/apis/management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/talon/apis/management-api/revisions/7ef1b9504c3a?raw)