---
title: consumptionStatus
framework: appstoreserverapi
role: symbol
role_heading: Type
path: appstoreserverapi/consumptionstatus
---

# consumptionStatus

A value that indicates the extent to which the customer consumed the In-App Purchase.

## Declaration

```data
int32 consumptionStatus
```

## Possible Values

0: The consumption status is undeclared. Use this value to avoid providing information for this field. 1: The In-App Purchase is not consumed. 2: The In-App Purchase is partially consumed. 3: The In-App Purchase is fully consumed.

## Discussion

Discussion Some examples of consumption status include the following scenarios: A customer purchases a “bag of 100 coins” in your app and spends all 100 coins. The In-App Purchase is considered fully consumed. If your app has an exchange platform that has bartering, or if your app transferred an In-App Purchase from one account to another customer’s account, the In-App Purchase is considered fully consumed.

## See Also

### Consumption data types

- [accountTenure](appstoreserverapi/accounttenure.md)
- [appAccountToken](appstoreserverapi/appaccounttoken.md)
- [customerConsented](appstoreserverapi/customerconsented.md)
- [deliveryStatusV1](appstoreserverapi/deliverystatusv1.md)
- [lifetimeDollarsPurchased](appstoreserverapi/lifetimedollarspurchased.md)
- [lifetimeDollarsRefunded](appstoreserverapi/lifetimedollarsrefunded.md)
- [platform](appstoreserverapi/platform.md)
- [playTime](appstoreserverapi/playtime.md)
- [refundPreferenceV1](appstoreserverapi/refundpreferencev1.md)
- [sampleContentProvided](appstoreserverapi/samplecontentprovided.md)
- [userStatus](appstoreserverapi/userstatus.md)