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 Purchases API

Manage in-app product and subscription purchases, including verification, acknowledgment, and consumption of purchase tokens.

Android Purchases 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 Purchases. 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 10 operations across 10 paths, and defines 15 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.

10 operations 10 paths 15 schemas 4 GET6 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 Purchases 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 10

Across 10 paths, the API surfaces 10 operations — 4 GET, 6 POST. Each is listed below with its method, path, parameters, and response codes.

Purchases 10

Manage in-app product and subscription purchases, including verification, acknowledgment, and consumption of purchase tokens.

GET
/applications/{packageName}/purchases/products/{productId}/tokens/{token}
Get In-app Product Purchase Status
getPurchaseProduct 3 params → 200401404
POST
/applications/{packageName}/purchases/products/{productId}/tokens/{token}:acknowledge
Acknowledge an In-app Product Purchase
acknowledgePurchaseProduct 3 params body → 204401404
POST
/applications/{packageName}/purchases/products/{productId}/tokens/{token}:consume
Consume an In-app Product Purchase
consumePurchaseProduct 3 params → 204401404
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}/purchases/voidedpurchases
List Voided Purchases
listVoidedPurchases 7 params → 200401

Schemas 15

The contract defines 15 schemas that model the data the API accepts and returns. The most detailed are SubscriptionPurchase (21 properties), ProductPurchase (15 properties), SubscriptionPurchaseV2 (11 properties), VoidedPurchase (8 properties). Each schema is shown below with its type and property counts.

SubscriptionPurchasesDeferResponse
object
Response from deferring a subscription purchase.
1 property
SubscriptionPurchasesDeferRequest
object
Request body for deferring a subscription purchase.
1 property 1 required
ProductPurchase
object
Represents an in-app product purchase. Contains the purchase state, consumption status, and order information.
15 properties
Error
object
Error response from the API.
1 property
VoidedPurchasesListResponse
object
Response containing a list of voided purchases.
3 properties
TokenPagination
object
Token-based pagination for large result sets.
2 properties
PageInfo
object
Pagination information for list responses.
3 properties
SubscriptionDeferralInfo
object
Contains the new desired expiry time for a subscription deferral.
2 properties 2 required
SubscriptionPurchasesAcknowledgeRequest
object
Request body for acknowledging a subscription purchase.
1 property
ProductPurchasesAcknowledgeRequest
object
Request body for acknowledging an in-app product purchase.
1 property
VoidedPurchase
object
A purchase that has been voided (cancelled, refunded, or charged back).
8 properties
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
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-purchases-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 Purchases 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.