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

# Subscription status

> Read the recorded subscription state for your app and user.

Backapp stores subscription state per app and user. Connect a provider under Integrations to sync its updates. [Adapty](https://docs.backapp.dev/integrations/adapty.md) is the available integration.

## Read subscription status

Use the variables from the [quickstart](https://docs.backapp.dev/quickstart.md).

```bash theme={null}
curl --fail-with-body --silent --show-error "$BACKAPP_BASE_URL/v2/me" \
  -H "X-App-Key: $BACKAPP_APP_KEY" \
  -H "X-App-Version: $BACKAPP_APP_VERSION" \
  -H "Authorization: Bearer $BACKAPP_ACCESS_TOKEN" |
  jq '.subscription'
```

| Field | Meaning |
| - | - |
| `is_active` | Whether Backapp has recorded active access for the user in this app. |
| `is_trial` | Whether the recorded state is a trial. |
| `product_id` | Recorded product identifier. It can be empty. |
| `expires_at` | Recorded expiration timestamp, or null. |
| `will_renew` | Recorded renewal status, or null when unknown. |

A user with no subscription record receives false for both boolean access flags, an empty product ID, and null for expiration and renewal. The device registration and token refresh responses include the same subscription summary.

Updates arrive asynchronously. The current image-effects endpoint runs independently of the reported subscription status.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.