You are here: Home > API Reference > App Management > Application > Retrieve paginated list of applications

Retrieve paginated list of applications

Required Permission: mad.application.management.list

Retrieves a paginated and filterable list of all mobile and desktop applications within the specified organization, allowing administrators to browse, search, and manage their application portfolio across multiple platforms and deployment environments.

GET
https://api.applivery.io/v1/organizations/{organizationId}/apps

Request

Send your API key in the request header authorization
Example: Authorization: Bearer <token>

organizationId string
required
Unique identifier or URL-friendly slug for the organization that owns the applications to operate on, establishing organizational scope for all nested application operations.
Match pattern: ^(([a-fA-F0-9]{24})|([a-zA-Z0-9\\-]{3,}))$

page integer
optional
Page number for result pagination starting from one, enabling navigation through large datasets by dividing results into manageable chunks.
limit integer
optional
Maximum number of items to return per page, controlling response size and enabling efficient data loading with configurable batch sizes.
sort string
optional
Ordering criteria using field:direction format to organize results based on specific attributes, supporting ascending or descending sort order.
Match pattern: ^[\w.]*((:asc)|(:desc))?$
name string
optional
Filter applications by exact or partial match on application name for finding specific apps in the organization.
≤ 128 characters
slug string
optional
Filter applications by exact or partial match on URL-friendly slug identifier.
≤ 128 characters
appToken string
optional
Filter applications by their unique application token used in SDK integrations and API authentication.
≤ 128 characters
oss string
optional
Filter applications by operating system platform support including ios, android, macos, or windows.
iosandroidaospmacoswindowspackage
platform string
optional
Filter applications by specific build platform or architecture variant for granular compatibility filtering.
≤ 256 characters
search string
optional
General search term to match against application name, slug, or other searchable fields for fuzzy finding.
≤ 256 characters
metadata object
optional
Filter applications by custom metadata key-value pairs matching specific organizational attributes or tags.
lean boolean
optional
Return minimal application data excluding heavy nested objects and statistics for faster response times when full details are not needed.

Responses

200 Response application/json
status boolean optional
data object optional
items array [object] optional
id string optional
Unique identifier for the application within the platform, used to reference this specific mobile or desktop app throughout the entire distribution workflow and analytics tracking.
Match pattern: ^[a-fA-F0-9]{24}$
name string optional
Human-readable name of the application that is displayed across the dashboard, distribution portals, and device management interfaces to help users identify the app being managed.
≤ 128 characters
slug string optional
URL-friendly unique identifier derived from the application name, used for public-facing store pages, download links, and shareable distribution URLs that end users will interact with.
≤ 128 characters · ≥ 3 characters · Match pattern: ^[a-z0-9][a-z0-9-]+[a-z0-9]$
sdk object optional
Platform-specific SDK configuration that governs how the mobile application interacts with the distribution platform, including update mechanisms, authentication, and version control for both iOS and Android.
notifications object optional
Notification preferences that control automated communication workflows for new builds, updates, and user feedback, enabling organizations to keep stakeholders informed throughout the application lifecycle management process.
description string optional
Detailed textual description of the application providing context about its purpose, target audience, key features, and business use case to help team members understand its role.
≤ 1000 characters
oss array [string] optional
Array of operating system platforms that this application supports or has builds available for, including iOS, Android, macOS, and Windows, enabling cross-platform distribution and device management capabilities.
buildPlatforms array [string] optional
List of specific build platforms and architectures that have been uploaded for this application, providing granular detail about device compatibility such as iOS universal, Android ARM64, or Windows x86.
security object optional
Security context object containing the current user's authorization level and permissions for this application, used to enforce role-based access control throughout the dashboard and API endpoints.
configuration object optional
Advanced configuration settings that control storage, security, retention policies, and integration parameters for this application, allowing administrators to customize behavior according to organizational policies and compliance requirements.
retentionApplied object optional
lastBuildProcessedDate string optional
Timestamp indicating when the most recent application build was successfully uploaded, processed, and made available for distribution, useful for tracking deployment cadence and identifying stale or inactive applications.
Format: date-time
picture string optional
URL or path to the application's icon image displayed in distribution portals, device management interfaces, and user-facing download pages to provide visual identification and branding consistency.
pictureSource string optional
Indicates the origin of the application icon image, whether manually uploaded by administrators, automatically extracted from uploaded build packages, or sourced from app store metadata synchronization processes.
manual last build
organization string optional
Unique identifier for the organization or tenant that owns and manages this application, establishing the organizational boundary for access control, billing, and resource isolation in multi-tenant environments.
Match pattern: ^[a-fA-F0-9]{24}$
counts object optional
Statistical metrics and aggregated counts related to this application, such as total number of builds, active installations, feedback submissions, or distribution downloads, providing operational insights and usage analytics.
metadata object optional
Flexible key-value object for storing custom application attributes, integration identifiers, or business-specific data that extends the core application model without requiring schema modifications for unique organizational requirements.
defaultScripts object optional
Predefined automation scripts that execute at specific lifecycle events for all builds of this application, such as post-upload processing, notification triggers, or integration webhooks that streamline deployment workflows.
createdBy string optional
Identifier and metadata about the user or system account that originally created this application record, providing audit trail information for compliance, security reviews, and organizational accountability tracking.
Match pattern: ^[a-fA-F0-9]{24}$
createdAt string optional
Timestamp indicating when this application was first registered in the platform, establishing the baseline for lifecycle tracking, billing calculations, and historical reporting of application management activities.
Format: date-time
updatedAt string optional
Timestamp indicating when this application record was last modified, including changes to configuration, metadata, or any other application properties, essential for change tracking and audit compliance requirements.
Format: date-time
totalDocs integer optional
limit integer optional
hasPrevPage boolean optional
hasNextPage boolean optional
page integer optional
totalPages integer optional
prevPage integer optional
nextPage integer optional
lean boolean optional 
{
    "status": true,
    "data": {
        "items": [
            {
                "id": "507f1f77bcf86cd799439011",
                "name": "Enterprise Mobile Banking App",
                "slug": "mobile-banking-app",
                "sdk": {
                    "ios": {
                        "ota": true,
                        "forceUpdate": false,
                        "minVersion": "2.5.0",
                        "forceAuth": true,
                        "detected": {
                            "sdkVersion": "3.2.1",
                            "capabilities": [
                                "ota",
                                "auth",
                                "feedback"
                            ],
                            "integrationValid": true
                        },
                        "lastBuildId": "507f1f77bcf86cd799439014",
                        "lastBuildVersion": "3.1.2"
                    },
                    "android": {
                        "ota": true,
                        "forceUpdate": false,
                        "minVersion": "2.5.0",
                        "forceAuth": true,
                        "detected": {
                            "sdkVersion": "3.2.1",
                            "capabilities": [
                                "ota",
                                "auth",
                                "feedback"
                            ],
                            "integrationValid": true
                        },
                        "lastBuildId": "507f1f77bcf86cd799439014",
                        "lastBuildVersion": "3.1.2"
                    }
                },
                "notifications": {
                    "newBuildNotifyCollaborators": true,
                    "newBuildNotifyEmployees": false,
                    "newBuildNotifyOtpUsers": false,
                    "newBuildMessage": "This release includes critical security patches and new features for enhanced mobile banking. Please update immediately to ensure continued access to your accounts.",
                    "newFeedbackNotifyCollaborators": true
                },
                "description": "A secure mobile banking application designed for enterprise customers, featuring biometric authentication, real-time transaction monitoring, and seamless integration with our core banking systems.",
                "oss": [
                    "ios",
                    "android"
                ],
                "buildPlatforms": [
                    "ios",
                    "android"
                ],
                "security": {
                    "role": "org.admin"
                },
                "configuration": {
                    "storageProvider": {
                        "id": "507f1f77bcf86cd799439012",
                        "name": "AWS S3 Production Bucket",
                        "region": "eu-west-1",
                        "config": "production-app-storage",
                        "provider": "aws-s3"
                    },
                    "emmJwtSignature": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkVudGVycHJpc2UgQXBwIn0.signature",
                    "notificationLanguage": "en",
                    "buildRetentionDays": 90,
                    "buildsRetainedPerPublication": 5
                },
                "retentionApplied": {
                    "maxBillingBuildRetentionDays": 0,
                    "buildsRetainedPerPublication": 0
                },
                "lastBuildProcessedDate": "2026-02-03T10: 30: 00.000Z",
                "picture": "https://cdn.applivery.com/apps/507f1f77bcf86cd799439011/icon.png",
                "pictureSource": "build",
                "organization": "507f1f77bcf86cd799439013",
                "counts": {
                    "totalBuilds": 127,
                    "activeInstalls": 3421,
                    "feedbackCount": 45
                },
                "metadata": {
                    "costCenter": "IT-2024",
                    "projectCode": "MOBILE-BANK-001",
                    "complianceLevel": "PCI-DSS"
                },
                "defaultScripts": {
                    "preInstall": "string",
                    "postInstall": "string",
                    "audit": "string",
                    "enforce": "string",
                    "runner": "string"
                },
                "createdBy": "507f1f77bcf86cd799439016",
                "createdAt": "2025-01-15T09: 00: 00.000Z",
                "updatedAt": "2026-02-03T14: 25: 00.000Z"
            }
        ],
        "totalDocs": 0,
        "limit": 0,
        "hasPrevPage": true,
        "hasNextPage": true,
        "page": 0,
        "totalPages": 0,
        "prevPage": 0,
        "nextPage": 0,
        "lean": true
    }
}
401 Response application/json
status boolean optional
false
error object optional
code number optional
4001
message string optional
Unauthorized
{
    "status": false,
    "error": {
        "code": 4002,
        "message": "No auth token"
    }
}
404 Response application/json
status boolean optional
false
error object optional
code number optional
3001
message string optional
Entity not found
{
    "status": false,
    "error": {
        "code": 3001,
        "message": "Entity not found"
    }
}
Was this page helpful?