# IAppManager.GetList()

Description:

The `GetList` method retrieves an iterable list of either user-installed applications or all applications on the mobile device, regardless of whether they were preinstalled or installed by the user.

This is a synchronous method.

Syntax:

    result = so.IAppManager.GetList(criteria);

Arguments:

- `criteria`:

  This is an object that specifies what information is returned about the applications on the device. For more information about the object properties and how to define them, see section Criteria for retrieving information about applications.

Return value:

The `GetList` method returns an object that contains the requested application information, an error code, and an error message

Table: Return value properties for GetList
Property | Description | Value
--- | --- | ---
`result.ReturnValue` | This is an iterator that contains the requested application information. | See Returned application information.
`result.ErrorCode` | This is a number that specifies a predefined error code. | See Service API error codes.
`result.ErrorMessage` | This is a text string that describes the error. | See AppManager Service API error messages.

Example code:

For the complete source of a sample widget that demonstrates how to use this Service API, see the full example.