> [!CAUTION]
> **Caution:** This documentation is for Google Ads API **v23** . The latest active version is [**v26**](https://developers.google.com/google-ads/api/fields/latest/applied_incentive).

[<button style="margin-top:15px">Help me build a query</button>](https://developers.google.com/google-ads/api/fields/v23/applied_incentive_query_builder.md.txt) [<button style="margin-top:15px">Proto definition ![GitHub](https://developers.google.com/site-assets/logo-github.svg)</button>](https://github.com/googleapis/googleapis/blob/master/google/ads/googleads/v23/resources/applied_incentive.proto)

Represents an applied incentive.

| Attributed resources |
|---|
| [customer](https://developers.google.com/google-ads/api/fields/v23/customer.md.txt) |

Fields from the above resources may be selected along with this
resource in your SELECT and WHERE clauses. These fields **will not segment**
metrics in your `SELECT` clause.

## applied_incentive.coupon_code

Field descriptionOutput only. The coupon code of the incentive.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[applied_incentive](https://developers.google.com/google-ads/api/fields/v23/applied_incentive.md.txt)

## applied_incentive.currency_code

Field descriptionOutput only. The currency code for all monetary amounts (for example,
"USD").
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[applied_incentive](https://developers.google.com/google-ads/api/fields/v23/applied_incentive.md.txt)

## applied_incentive.current_spend_towards_fulfillment_micros

Field descriptionOutput only. The current amount spent towards the fulfillment requirements,
in micros.
Category`ATTRIBUTE` Data Type`INT64` Type URL`N/A` FilterableFalse SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[applied_incentive](https://developers.google.com/google-ads/api/fields/v23/applied_incentive.md.txt)

## applied_incentive.fulfillment_expiration_date_time

Field descriptionOutput only. The time by which the incentive's fulfillment requirements
must be met, in "YYYY-MM-DD HH:MM:SS" format in UTC.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[applied_incentive](https://developers.google.com/google-ads/api/fields/v23/applied_incentive.md.txt)

## applied_incentive.granted_amount_micros

Field descriptionOutput only. The amount of the reward granted in micros.
This field is not set if the reward has not been granted.
Category`ATTRIBUTE` Data Type`INT64` Type URL`N/A` FilterableFalse SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[applied_incentive](https://developers.google.com/google-ads/api/fields/v23/applied_incentive.md.txt)

## applied_incentive.incentive_state

Field descriptionOutput only. The current state of the incentive.
Category`ATTRIBUTE` Data Type `ENUM`
`EXPIRED``FULFILLED``INVALIDATED``REDEEMED``REWARD_EXHAUSTED``REWARD_EXPIRED``REWARD_GRANTED``UNKNOWN``UNSPECIFIED` Type URL`google.ads.googleads.v23.enums.IncentiveStateEnum.IncentiveState` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[applied_incentive](https://developers.google.com/google-ads/api/fields/v23/applied_incentive.md.txt)

## applied_incentive.redemption_date_time

Field descriptionOutput only. The redemption time of the incentive in "YYYY-MM-DD HH:MM:SS"
format in UTC.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[applied_incentive](https://developers.google.com/google-ads/api/fields/v23/applied_incentive.md.txt)

## applied_incentive.required_min_spend_micros

Field descriptionOutput only. The minimum amount that must be spent to fulfill the coupon
requirements, in micros.
Category`ATTRIBUTE` Data Type`INT64` Type URL`N/A` FilterableFalse SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[applied_incentive](https://developers.google.com/google-ads/api/fields/v23/applied_incentive.md.txt)

## applied_incentive.resource_name

Field descriptionOutput only. The resource name of the incentive.
Incentive resource names have the form:

`customers/{customer_id}/appliedIncentives/{coupon_code}`
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` Type URL`N/A` FilterableTrue SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[applied_incentive](https://developers.google.com/google-ads/api/fields/v23/applied_incentive.md.txt)

## applied_incentive.reward_amount_micros

Field descriptionOutput only. The maximum potential reward amount in micros for the
incentive.
Category`ATTRIBUTE` Data Type`INT64` Type URL`N/A` FilterableFalse SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[applied_incentive](https://developers.google.com/google-ads/api/fields/v23/applied_incentive.md.txt)

## applied_incentive.reward_balance_remaining_micros

Field descriptionOutput only. The remaining balance of the granted reward in micros.
This field is not set if the reward has not been granted.
Category`ATTRIBUTE` Data Type`INT64` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[applied_incentive](https://developers.google.com/google-ads/api/fields/v23/applied_incentive.md.txt)

## applied_incentive.reward_expiration_date_time

Field descriptionOutput only. The time when the granted reward expires in "YYYY-MM-DD
HH:MM:SS" format in UTC. This field is not set if the reward has not been
granted.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[applied_incentive](https://developers.google.com/google-ads/api/fields/v23/applied_incentive.md.txt)

## applied_incentive.reward_grant_date_time

Field descriptionOutput only. The time when the reward was granted in "YYYY-MM-DD HH:MM:SS"
format in UTC. This field is not set if the reward has not been granted.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[applied_incentive](https://developers.google.com/google-ads/api/fields/v23/applied_incentive.md.txt)