How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Android Subscriptions API

Create, manage, and query subscription products and their base plans, offers, and purchase entitlements.

Android Subscriptions API is one of 24 APIs that Android publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include Subscription. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a JSON-LD context, release notes, and 1 JSON Schema.

This API exposes 13 operations across 9 paths, and defines 18 schemas. It is described by OpenAPI 3.2.0, at version 3.0.

Requests are made against a single base URL, https://androidpublisher.googleapis.com/androidpublisher/v3.

13 operations 9 paths 18 schemas 1 DELETE5 GET1 PATCH6 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
3.0
Base URL
https://developer.android.com
Authentication
OAuth 2.0
Terms of Service
Resource Areas
1

Authentication & Security 1

Android Subscriptions API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (oauth2) using the authorizationCode flow, exposing 1 scope. By default, every request must be authenticated.

  • oauth2 — OAuth 2.0 authentication for accessing the Google Play Developer API. Requires a service account with appropriate permissions in the Google Play Console.

Paths & Operations 13

Across 9 paths, the API surfaces 13 operations — 1 DELETE, 5 GET, 1 PATCH, 6 POST. Each is listed below with its method, path, parameters, and response codes.

Subscriptions 13

Create, manage, and query subscription products and their base plans, offers, and purchase entitlements.

GET
/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}
Get Subscription Purchase Status
getPurchaseSubscription 3 params → 200401404
POST
/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:acknowledge
Acknowledge a Subscription Purchase
acknowledgePurchaseSubscription 3 params body → 204401404
POST
/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:cancel
Cancel a Subscription Purchase
cancelPurchaseSubscription 3 params → 204401404
POST
/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:defer
Defer a Subscription Purchase
deferPurchaseSubscription 3 params body → 200401404
POST
/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:revoke
Revoke a Subscription Purchase
revokePurchaseSubscription 3 params → 204401404
GET
/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}
Get Subscription Purchase V2
getSubscriptionPurchaseV2 2 params → 200401404
GET
/applications/{packageName}/monetization/subscriptions
List Subscription Products
listSubscriptions 4 params → 200401
POST
/applications/{packageName}/monetization/subscriptions
Create a Subscription Product
createSubscription 3 params body → 200401409
GET
/applications/{packageName}/monetization/subscriptions/{productId}
Get a Subscription Product
getSubscription 2 params → 200401404
PATCH
/applications/{packageName}/monetization/subscriptions/{productId}
Update a Subscription Product
updateSubscription 5 params body → 200401404
DELETE
/applications/{packageName}/monetization/subscriptions/{productId}
Delete a Subscription Product
deleteSubscription 2 params → 204401404
GET
/applications/{packageName}/monetization/subscriptions/{productId}/basePlans/{basePlanId}/offers
List Subscription Offers
listSubscriptionOffers 5 params → 200401
POST
/applications/{packageName}/monetization/subscriptions/{productId}/basePlans/{basePlanId}/offers
Create a Subscription Offer
createSubscriptionOffer 5 params body → 200401

Schemas 18

The contract defines 18 schemas that model the data the API accepts and returns. The most detailed are SubscriptionPurchase (21 properties), SubscriptionPurchaseV2 (11 properties), SubscriptionOffer (9 properties), BasePlan (6 properties). Each schema is shown below with its type and property counts.

SubscriptionPurchasesDeferResponse
object
Response from deferring a subscription purchase.
1 property
BasePlan
object
A base plan specifies the billing period and renewal type for a subscription. A subscription must have at least one base plan.
6 properties
SubscriptionPurchasesDeferRequest
object
Request body for deferring a subscription purchase.
1 property 1 required
Error
object
Error response from the API.
1 property
SubscriptionListing
object
Localized listing information for a subscription.
4 properties
ListSubscriptionOffersResponse
object
Response containing a list of subscription offers.
2 properties
Subscription
object
A subscription product defined in the Google Play Console. Contains base plans, listings, and tax and compliance settings.
6 properties
ListSubscriptionsResponse
object
Response containing a list of subscriptions.
2 properties
SubscriptionDeferralInfo
object
Contains the new desired expiry time for a subscription deferral.
2 properties 2 required
SubscriptionTaxAndComplianceSettings
object
Tax and compliance settings for a subscription.
3 properties
SubscriptionOffer
object
A subscription offer represents special pricing for a subscription, such as a free trial or introductory price.
9 properties
SubscriptionPurchasesAcknowledgeRequest
object
Request body for acknowledging a subscription purchase.
1 property
SubscriptionPurchase
object
Represents a subscription purchase. Contains the subscription state, expiry time, auto-renewal status, and cancellation details.
21 properties
IntroductoryPriceInfo
object
Contains the introductory price information for a subscription.
4 properties
SubscriptionPurchaseLineItem
object
An individual line item within a v2 subscription purchase. Each line item represents a base plan or offer.
5 properties
SubscriptionOfferPhase
object
A single phase of a subscription offer. Defines pricing for a specific period.
3 properties
Money
object
Represents a monetary amount with currency.
3 properties
SubscriptionPurchaseV2
object
Indicates the v2 subscription purchase details, including subscription state, line items, and external account information.
11 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

android-subscriptions-api-openapi.yml Raw ↑

Other APIs Android publishes across the network.

Android Platform APIs
Google Play Services APIs
Firebase Android APIs
Google Maps Android API
Android Jetpack APIs
Google Play Console API
Google Play Billing API
Android NDK APIs
Google ML Kit Android APIs
Android Health Connect API
Android CameraX API
Wear OS APIs
Where this information came from

This is an independent, third-party profile of Android Subscriptions API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.