# StartMfaPhoneRequestInfo

- [JSON representation](https://docs.cloud.google.com/identity-platform/docs/reference/rest/v2/StartMfaPhoneRequestInfo#SCHEMA_REPRESENTATION)
- [AutoRetrievalInfo](https://docs.cloud.google.com/identity-platform/docs/reference/rest/v2/StartMfaPhoneRequestInfo#AutoRetrievalInfo)
  - [JSON representation](https://docs.cloud.google.com/identity-platform/docs/reference/rest/v2/StartMfaPhoneRequestInfo#AutoRetrievalInfo.SCHEMA_REPRESENTATION)

App Verification info for a StartMfa request.

| JSON representation |
|---|
| ``` { "phoneNumber": string, "iosReceipt": string, "iosSecret": string, "recaptchaToken": string, "autoRetrievalInfo": { object (`https://docs.cloud.google.com/identity-platform/docs/reference/rest/v2/StartMfaPhoneRequestInfo#AutoRetrievalInfo`) }, "safetyNetToken": string, "playIntegrityToken": string, "captchaResponse": string, "clientType": enum (`https://docs.cloud.google.com/identity-platform/docs/reference/rest/v2/ClientType`), "recaptchaVersion": enum (`https://docs.cloud.google.com/identity-platform/docs/reference/rest/v2/RecaptchaVersion`) } ``` |

| Fields ||
|---|---|
| `phoneNumber` | `string` Required for enrollment. Phone number to be enrolled as MFA. |
| `iosReceipt` | `string` iOS only. Receipt of successful app token validation with APNS. |
| `iosSecret` | `string` iOS only. Secret delivered to iOS app via APNS. |
| `recaptchaToken` | `string` Web only. Recaptcha solution. |
| `autoRetrievalInfo` | ``object (`https://docs.cloud.google.com/identity-platform/docs/reference/rest/v2/StartMfaPhoneRequestInfo#AutoRetrievalInfo`)`` Android only. Used by Google Play Services to identify the app for auto-retrieval. |
| `safetyNetToken` | `string` Android only. Used to assert application identity in place of a recaptcha token. A SafetyNet Token can be generated via the [SafetyNet Android Attestation API](https://developer.android.com/training/safetynet/attestation.html), with the Base64 encoding of the `phoneNumber` field as the nonce. |
| `playIntegrityToken` | `string` Android only. Used to assert application identity in place of a recaptcha token (or safety net token). A Play Integrity Token can be generated via the [PlayIntegrity API](https://developer.android.com/google/play/integrity) with applying SHA256 to the `phoneNumber` field as the nonce. |
| `captchaResponse` | `string` The reCAPTCHA Enterprise token provided by the reCAPTCHA client-side integration. Required when reCAPTCHA enterprise is enabled. |
| `clientType` | ``enum (`https://docs.cloud.google.com/identity-platform/docs/reference/rest/v2/ClientType`)`` The client type, web, android or ios. Required when reCAPTCHA Enterprise is enabled. |
| `recaptchaVersion` | ``enum (`https://docs.cloud.google.com/identity-platform/docs/reference/rest/v2/RecaptchaVersion`)`` The reCAPTCHA version of the reCAPTCHA token in the captchaResponse. Required when reCAPTCHA Enterprise is enabled. |

## AutoRetrievalInfo

The information required to auto-retrieve an SMS.

| JSON representation |
|---|
| ``` { "appSignatureHash": string } ``` |

| Fields ||
|---|---|
| `appSignatureHash` | `string` The Android app's signature hash for Google Play Service's SMS Retriever API. |