Retrieve an app install

Changed on

Retrieves an app install. The installing account, the app’s developer (with the keys of the account that owns the app or of the app’s managed sandbox), and the embedding platform that created the install can retrieve it.

get/v1/apps/installs/{id}

Request

  • Base URL: https://api.stripe.com
  • URL: https://api.stripe.com/v1/apps/installs/{id}
  • Auth: one of:
    • HTTP basic
    • HTTP bearer

Path parameters

idstring required

Query parameters

expandstring[]

Specifies which fields in the response should be expanded.

Response

Successful response.

accountstring required

The ID of the account that the app install belongs to.

appstring required

The ID of the app installed.

approval_requiredboolean required

Whether the installer must authorize pending permissions, content security policy entries, or endpoints. For private apps, approval_required stays false; creating or reauthorizing the install through the API installs the newest completed upload and grants its permissions.

auth_codestring nullable

The authorization code for an oauth app install.

channel'private_live' | 'private_test' | 'public' | 'review' | 'testing' required

The distribution channel associated with the app install.

createdinteger required

Time at which the object was created. Measured in seconds since the Unix epoch.

created_bystring nullable

The ID of the embedding platform that created the install, if applicable.

endpoints_grantedstring[] required

The endpoint URLs authorized by the installer.

endpoints_pendingstring[] required

The endpoint URLs requested by the latest app version that the installer has not authorized.

idstring required

Unique identifier for the object.

livemodeboolean required

If the object exists in live mode, the value is true. If the object exists in test mode, the value is false.

object'apps.install' required

String representing the object's type. Objects of the same type share the same value.

permissions_grantedstring[] required

The permissions authorized by the installer.

permissions_pendingstring[] required

The permissions requested by the latest app version that the installer has not authorized.

status'install_failed' | 'installed' | 'installing' | 'uninstall_failed' | 'uninstalling' required

The status of the app install.

Changes

  • 8b5c2f03d4cdRevision changes
    • info

      added the optional property /////////// to the response with the status

    • info

      added the optional property /////////// to the response with the status

    • info

      added the optional property /////////// to the response with the status

    • info

      added the optional property /////////// to the response with the status

    • info

      added the optional property /////////// to the response with the status

    • info

      added the optional property /////////// to the response with the status

    • info

      added the optional property /////////// to the response with the status

    • info

      added the optional property /////////// to the response with the status

    • info

      added the optional property /////////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    This list may be incomplete.

Some revisions have not been checked yet.