Method: accounts.verifyIosClient

Stay organized with collections Save and categorize content based on your preferences.

Verifies an iOS client is a real iOS device. If the request is valid, a receipt will be sent in the response and a secret will be sent via Apple Push Notification Service. The client should send both of them back to certain Identity Platform APIs in a later call (for example, /accounts:sendVerificationCode), in order to verify the client. The bundle ID is required in the request header as x-ios-bundle-identifier.

An API key is required in the request in order to identify the Google Cloud project.

HTTP request


The URL uses gRPC Transcoding syntax.

Request body

The request body contains data with the following structure:

JSON representation
  "appToken": string,
  "isSandbox": boolean


A device token that the iOS client gets after registering to APNs (Apple Push Notification service).



Whether the app token is in the iOS sandbox. If false, the app token is in the production environment.

Response body

If successful, the response body contains data with the following structure:

Response message for accounts.verifyIosClient.

JSON representation
  "receipt": string,
  "suggestedTimeout": string


Receipt of successful app token validation.


string (int64 format)

Suggested time that the client should wait in seconds for delivery of the push notification.

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.