Get native apps by organization ID

Get native apps by organization ID.

Request

This request uses the GET method, which is used to retrieve a paginated list of mobile apps with their metadata associated with a specific organization. This allows users to view and manage the applications uploaded to their organization's TestCloud environment.

Replace {your_access_token} with your actual API access token. The Authorization header should follow the format: Bearer your_access_token. This token authenticates your request to the Katalon TestCloud API. See the following topic for more information: JSON Web Token Authentication.

The request data is provided as a JSON object. You can optionally include the following query parameters:

  • pageToken: Token for retrieving the next page of results. Use the token provided in the previous response.
    limit: Number of records to return per page. Defaults to 10 if not specified.
  • size: The number of application records to return per page.
  • sort: Sorts the results by using a specific sorting field.

Response

A successful response returns a JSON object containing a list of mobile applications that match the specified query parameters. Each application object typically includes details such as the application's ID, name, version, and the date it was last updated.

See the following example:

{
    "count": 31,
    "pageToken": "0",
    "items": [
        {
            "id": "00185b37-53cb-4cea-b5d7-95c9dcd55e3d",
            "organizationId": "278985",
            "name": "TC App",
            "platform": "android",
            "status": "READY",
            "size": 3413991,
            "storagePath": "7d839910-48a9-4686-90ee-dd2e4710d29a",
            "uploadedDate": "2022-10-25T04:37:22Z",
            "metadata": {
                "appUri": "storage:17c65e8f-0511-4c0a-819c-f3ab798b6814",
                "identifier": "com.katalon.testcloud.tcapp",
                "name": "TC App",
                "version": "1.0",
                "minSdk": 21,
                "targetSdk": 32
            },
            "createdDate": "2022-10-25T04:37:20.102617",
            "updatedDate": "2022-10-25T04:37:22.870772",
            "fileName": "tcapp.apk"
        }
    ]
]    

Refer to the following table about the response body properties:

PropertyTypeDescription
countIntegerNumber of native apps under the identified organization.
pageTokenIntegerIndicates the number of paginated results.
itemsObjectObject property containing mobile app metadata for the identified organization.
idIntegerThe mobile app ID.
organizationIdIntegerThe organization ID.
nameStringThe app name.
platformStringThe platform name.
statusStringStatus of the mobile app (NEW, UPLOADING, READY, ERROR)
sizeIntegerThe file size.
storagePathIntegerThe storage path in S3. See Request URL to upload mobile app.
metadataObjectMobile app metadata.
metadata.appUriIntegerThe application ID.
metadata.identifierStringThe iOS app bundle identifier or the Android app application ID.
metadata.nameStringThe app name.
metadata.versionStringThe app version.
metadata.minSdkIntegerThe min SDK on Android.
metadata.tartgetSdkIntegerThe target SDK on Android.

Try it!

  1. Enter the required (and optional, if applicable) fields below.
  2. Select the language in Language.
  3. Enter your user name or API credentials.
  4. Review your API call and click Try it!
Language
Credentials
Bearer
JWT
Click Try It! to start a request and see the response here!