curl --request GET \
--url https://api.fanvue.com/apps/{appUuid}/subscription/me \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/apps/{appUuid}/subscription/me"
headers = {
"X-Fanvue-API-Version": "<x-fanvue-api-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-Fanvue-API-Version': '<x-fanvue-api-version>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.fanvue.com/apps/{appUuid}/subscription/me', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"appUuid": "00000000-0000-4000-8000-000000000001",
"userUuid": "00000000-0000-4000-8000-000000000003",
"hasActiveSubscription": true,
"status": "active",
"planUuid": "00000000-0000-4000-8000-000000000002",
"planName": "Pro Monthly",
"currentPeriodEnd": "2026-05-01T00:00:00.000Z",
"cancelAtPeriodEnd": false,
"managedCreators": [
{
"userUuid": "00000000-0000-4000-8000-000000000004",
"hasActiveSubscription": true,
"status": "active",
"planUuid": "00000000-0000-4000-8000-000000000002",
"planName": "Pro Monthly",
"currentPeriodEnd": "2026-05-01T00:00:00.000Z",
"cancelAtPeriodEnd": false
}
]
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"message": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}{
"message": "<string>"
}{
"message": "<string>"
}Get current user subscription for an installed app
Returns paid entitlement for the authenticated user for the app identified by appUuid. The OAuth access token must belong to that app.
When the authenticated user is an agency team member, the response also includes a managedCreators array containing the subscription state for every creator the team member is assigned to. The agency user’s own top-level subscription will be status: "none" (agency team members do not install apps themselves). For non-agency users managedCreators is an empty array.
A status: "pending" entry with currentPeriodEnd: null is a checkout awaiting payment: the user is not entitled to the plan yet, so planUuid and planName are null until the payment settles. A pending entry with a non-null currentPeriodEnd is a paid subscription with an in-flight cancellation and keeps its plan fields.
curl --request GET \
--url https://api.fanvue.com/apps/{appUuid}/subscription/me \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/apps/{appUuid}/subscription/me"
headers = {
"X-Fanvue-API-Version": "<x-fanvue-api-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-Fanvue-API-Version': '<x-fanvue-api-version>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.fanvue.com/apps/{appUuid}/subscription/me', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"appUuid": "00000000-0000-4000-8000-000000000001",
"userUuid": "00000000-0000-4000-8000-000000000003",
"hasActiveSubscription": true,
"status": "active",
"planUuid": "00000000-0000-4000-8000-000000000002",
"planName": "Pro Monthly",
"currentPeriodEnd": "2026-05-01T00:00:00.000Z",
"cancelAtPeriodEnd": false,
"managedCreators": [
{
"userUuid": "00000000-0000-4000-8000-000000000004",
"hasActiveSubscription": true,
"status": "active",
"planUuid": "00000000-0000-4000-8000-000000000002",
"planName": "Pro Monthly",
"currentPeriodEnd": "2026-05-01T00:00:00.000Z",
"cancelAtPeriodEnd": false
}
]
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"message": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}{
"message": "<string>"
}{
"message": "<string>"
}read:self— Access your own user profile information, including basic account details and settings.
Authorizations
OAuth 2.0 access token, presented as a JWT bearer token in the Authorization header. Obtain a token via the authorization-code flow; the scopes granted to the token determine which operations it may call.
Headers
API version to use for the request
"2025-06-26"
Path Parameters
"00000000-0000-4000-8000-000000000001"
Response
Current-user subscription entitlement for the app
active, pending, cancelled, none Show child attributes
Show child attributes
Was this page helpful?