List accessible organization workspaces

GET

/v1/organizations/

List accessible organization workspaces

Required Permission: base.organization.management.list

Retrieves a paginated list of workspaces accessible to the authenticated user. This includes filtering and sorting options to enable efficient navigation and management across multiple workspaces

Request

Add parameter in header authorization

Example: Authorization: Bearer <token>

page integer

optional

Page number for pagination controls starting at one enabling navigation through large organization collections efficiently.

limit integer

optional

Maximum number of organizations returned per page controlling result set size for pagination and performance optimization.

sort string

optional

Sort field and direction for ordering organization list results enabling customized data presentation and filtering.

Match pattern: ^[\w.]*((:asc)|(:desc))?$

name string

optional

Organization display name shown throughout dashboard interface for workspace identification and administrative purposes across all features.

≤ 128 characters

slug string

optional

URL-friendly workspace identifier enabling human-readable access paths and custom branding in dashboard URLs and API endpoints.

≤ 128 characters

Responses

200 Response application/json

status boolean optional

data object optional

items array [object] optional

id string optional

Organization unique identifier used for database references, API responses, and internal system operations throughout platform.

Match pattern: ^[a-fA-F0-9]{24}$

name string optional

Organization display name shown throughout dashboard interface for workspace identification and administrative purposes across all features.

≤ 128 characters

slug string optional

URL-friendly workspace identifier enabling human-readable access paths and custom branding in dashboard URLs and API endpoints.

≤ 128 characters · ≥ 3 characters · Match pattern: ^[a-zA-Z0-9][a-zA-Z0-9-]+[a-zA-Z0-9]$

webSiteUrl string optional

Public website URL for organization providing external reference link displayed in workspace settings and support communications.

≤ 256 characters

type string optional

Organization classification type defining workspace scope and administrative boundaries currently limited to company entity type.

personal company

subscriptions array [object] optional

Active and historical subscription records defining workspace access permissions feature entitlements and billing status.

plan string optional

Subscription plan identifier referencing pricing tier feature set and resource limits for workspace.

Match pattern: ^[a-fA-F0-9]{24}$

planCode string optional

Human-readable plan code identifying subscription tier for billing and support reference purposes.

≤ 256 characters

iniDate string optional

Subscription start date in ISO format marking beginning of billing cycle and feature access.

Format: date-time

endDate string optional

Subscription end date in ISO format indicating renewal deadline or cancellation effective date.

Format: date-time

endedAt string optional

Actual subscription termination timestamp when canceled or expired with null indicating active status.

Format: date-time

status string optional

Current subscription state indicating payment health and access validity including active canceled past_due expired.

active canceled past_due expired

metadata object optional

Subscription plan metadata containing feature limits allowed capabilities pricing details and target configuration.

limits object optional

Resource quota limits defining maximum allowed applications builds downloads collaborators and managed devices.

allows object optional

Feature capability flags indicating which advanced features are enabled for subscription tier.

target string optional

Subscription plan target indicating resource type being metered such as devices users or builds.

company personal unknown

type string optional

Subscription business model type indicating SaaS perpetual or trial licensing arrangement.

standard default unknown mdm custom enterprise

periodicity string optional

Billing cycle frequency defining monthly annual or custom payment intervals with null for one-time.

m y d -

price integer optional

Base subscription price per billing period in smallest currency unit for chosen plan tier.

≥ 0

packagePrice integer optional

Additional unit price for exceeding included package limits enabling consumption-based billing.

≥ 0

packageLength integer optional

Number of units included in base subscription package before additional charges apply.

≥ 0

packageTarget string optional

Resource type for package-based pricing defining what units are counted for overage charges.

≤ 128 characters

chargeType string optional

Billing charge calculation method defining how subscription costs are computed and invoiced.

≤ 128 characters

customer string optional

Billing customer identifier linking subscription to payment method and invoice records in billing platform.

Match pattern: ^[a-fA-F0-9]{24}$

id string optional

Match pattern: ^[a-fA-F0-9]{24}$

planDescription string optional

Human-readable subscription plan description displayed in dashboard and billing communications.

≤ 128 characters

type string optional

standard default unknown mdm custom enterprise

description string optional

Detailed subscription description explaining included features limits and special terms for workspace access.

≤ 256 characters

paymentIntent object optional

Payment processing information including transaction status errors and authentication requirements for subscription.

id string optional

≤ 128 characters

secret string optional

≤ 500 characters

status string optional

≤ 500 characters

error object optional

loginProviders object optional

Authentication provider configurations defining allowed login methods for dashboard store and MDM portal access security.

dashboard array [string] optional

Allowed authentication methods for dashboard access including password Google SSO enabling administrative login security configuration.

store array [string] optional

Allowed authentication methods for application store access controlling employee login mechanisms and security policies.

mdm array [string] optional

Allowed authentication methods for MDM portal access defining device administrator login options and security requirements.

limits object optional

Resource quota limits derived from active subscription defining maximum allowed applications builds downloads and devices.

apps integer optional

≥ 0

builds integer optional

≥ 0

downloads integer optional

≥ 0

collaborators integer optional

≥ 0

employees integer optional

≥ 0

mdmDevices integer optional

≥ 0

locationTrackingTime integer optional

≥ 0

mdmAssetsStorageSize integer optional

≥ 0

maxBuildRetentionDays integer optional

≥ 0

maxBuildsRetainedPerPublication integer optional

≥ 0

maxPublicationsPerApp integer optional

≥ 0

mdmAutomationRules integer optional

≥ 0

deviceAudiences integer optional

≥ 0

userAudiences integer optional

≥ 0

maxDepthSegments integer optional

≥ 0

maxNumSegments integer optional

≥ 0

allows object optional

Feature capability flags derived from subscription indicating which advanced features are enabled for workspace.

passwordApps boolean optional

loggedApps boolean optional

unlistedApps boolean optional

loggedStores boolean optional

nativeSDK boolean optional

customBranding boolean optional

customDomain boolean optional

ssoLogin boolean optional

changeS3Bucket boolean optional

customS3Bucket boolean optional

appleIpad boolean optional

appleMac boolean optional

appleWatch boolean optional

appleTv boolean optional

androidZeroTouch boolean optional

appleDEP boolean optional

appleVPP boolean optional

serviceAccounts boolean optional

duplicatePolicy boolean optional

mdmAssets boolean optional

advancedLauncher boolean optional

androidAgent boolean optional

iosAgent boolean optional

macosAgent boolean optional

macosScripts boolean optional

androidManagedConfigurations boolean optional

appleManagedConfigurations boolean optional

androidRemoteSupport boolean optional

appleRemoteSupport boolean optional

inventory boolean optional

windowsMdm boolean optional

windowsAgent boolean optional

windowsScripts boolean optional

countryAccessControl boolean optional

assistant boolean optional

userAudiences boolean optional

unlimitedBuildRetention boolean optional

policyComposition boolean optional

deviceAudiences boolean optional

certificateProviders boolean optional

segments boolean optional

counts object optional

Current resource usage statistics showing consumed quotas for applications collaborators devices and storage.

contactInfo object optional

Organization contact information for support communications, billing notifications, and administrative correspondence throughout system.

email string optional

Primary contact email address for organization receiving system notifications, support responses, and billing communications.

≤ 256 characters · Format: email

phoneNumber string optional

Organization contact phone number for support escalations and administrative communications when required.

≤ 128 characters

store object optional

Application store configuration settings defining custom domain and employee access portal customization.

customDomain string optional

Custom domain name for branded application store replacing default Applivery URLs with organization domain.

≤ 256 characters

branding object optional

Visual identity customization settings including logo images and color schemes for white-label workspace presentation.

logo string optional

Organization logo image URL displayed in dashboard header, emails, and application stores for brand recognition.

≤ 256 characters

picture string optional

Organization banner picture URL used for workspace customization and visual identity in user-facing interfaces.

primaryColor string optional

Primary brand color in hexadecimal format applied throughout dashboard interface for consistent visual identity.

Match pattern: ^#[a-zA-Z0-9]{6}$

security object optional

Security context for authenticated user including access role and permission level within workspace.

role string optional

Access permission level granted to currently authenticated user within organization context determining authorized administrative actions.

org.owner org.admin org.editor org.viewer app.owner app.admin app.editor app.viewer unknown

configuration object optional

Organization operational settings with storage provider details and complete feature configuration policies.

storageProvider object optional

Cloud storage provider details including identifier name region and configuration for application binary hosting.

id string optional

Storage provider unique identifier used for database references and API operations.

Match pattern: ^[a-fA-F0-9]{24}$

name string optional

Storage provider display name identifying cloud service and region for administrative reference.

≤ 128 characters

region string optional

Cloud provider geographic region code where application binaries and assets are stored.

≤ 128 characters

config string optional

Storage configuration type defining bucket settings access policies and performance characteristics.

≤ 128 characters

provider string optional

Cloud provider identifier indicating storage backend such as AWS Azure or Google Cloud Platform.

≤ 128 characters

notificationLanguage string optional

Default language code for system notifications and automated emails sent to organization members.

es en fr de it zh pt ru

required2FADashboard boolean optional

Flag enforcing two-factor authentication requirement for all dashboard access enhancing workspace security.

required2FAStore boolean optional

Flag enforcing two-factor authentication requirement for application store access protecting employee app distribution.

noReplyAlias string optional

Custom no-reply email address displayed as sender in automated notifications for organization branding.

≤ 256 characters · Format: email

buildPlatforms array [string] optional

List of mobile platforms enabled for build processing including iOS Android Windows macOS tvOS watchOS.

sdkExtraBuildPlatforms array [string] optional

Additional platform build capabilities available through SDK integration beyond standard build processing.

denyTraditionalAccess boolean optional

Flag restricting traditional password authentication requiring SSO or alternative login methods for enhanced security.

buildRetentionDays number optional

Number of days to retain application builds before automatic deletion with negative one indicating unlimited retention.

Format: float · ≥ -1

buildsRetainedPerPublication number optional

Maximum number of builds preserved per publication release protecting storage while maintaining version history.

Format: float · ≥ 0

showDeviceNetworkLocation boolean optional

Flag enabling network location information display in device details for connectivity diagnostics.

blocked boolean optional

Flag indicating workspace suspension status preventing access when payment issues or policy violations detected.

blockedReason string optional

Explanation for workspace suspension describing payment failure policy violation or administrative action causing block.

≤ 256 characters

trialIniDate string optional

Trial period start date in ISO format with null indicating no trial or converted paid subscription.

Format: date-time

trialEndDate string optional

Trial period expiration date when free access ends requiring subscription upgrade or workspace suspension.

Format: date-time

lastPlan string optional

Most recent subscription plan code for workspace enabling billing history tracking and renewal recommendations.

≤ 128 characters

billingReason string optional

Current billing status reason explaining subscription state such as trial active canceled or payment issues.

noBilling noSubs subscribe

lastActivityDate string optional

Format: date-time

createdBy string optional

User identifier who created organization workspace establishing initial ownership and administrative responsibility.

Match pattern: ^[a-fA-F0-9]{24}$

createdAt string optional

ISO timestamp when organization workspace was created for lifecycle tracking and audit purposes.

Format: date-time

updatedAt string optional

ISO timestamp of last organization modification for change tracking synchronization and audit trail.

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": "698f42e5457fafa13d088794",
                "name": "Acme Corporation",
                "slug": "acme-corp",
                "webSiteUrl": "https://www.acmecorp.com",
                "type": "company",
                "subscriptions": [
                    {
                        "plan": "698f42e5457fafa13d088796",
                        "planCode": "enterprise-annual",
                        "iniDate": "2026-01-01T00: 00:00Z",
                        "endDate": "2027-01-01T00: 00:00Z",
                        "endedAt": null,
                        "status": "active",
                        "metadata": {},
                        "customer": "698f42e5457fafa13d088797",
                        "id": "string",
                        "planDescription": "Enterprise Plan",
                        "type": "standard",
                        "description": "Annual enterprise subscription with unlimited devices",
                        "paymentIntent": {
                            "id": "pi_1234567890",
                            "secret": "pi_1234567890_secret_abcdefgh",
                            "status": "succeeded",
                            "error": {}
                        }
                    }
                ],
                "loginProviders": {
                    "dashboard": [
                        "traditional",
                        "saml"
                    ],
                    "store": [
                        "traditional",
                        "social"
                    ],
                    "mdm": [
                        "traditional"
                    ]
                },
                "limits": {
                    "apps": 50,
                    "builds": 1000,
                    "downloads": 100000,
                    "collaborators": 25,
                    "employees": 500,
                    "mdmDevices": 1000
                },
                "allows": {
                    "customBranding": true,
                    "ssoLogin": true,
                    "customS3Bucket": true,
                    "androidAgent": true,
                    "iosAgent": true
                },
                "counts": {
                    "apps": 12,
                    "collaborators": 8,
                    "devices": 247
                },
                "contactInfo": {
                    "email": "[email protected]",
                    "phoneNumber": "+1-555-0100"
                },
                "store": {
                    "customDomain": "apps.acmecorp.com"
                },
                "branding": {
                    "logo": "https://cdn.acmecorp.com/logo.png",
                    "picture": "https://cdn.acmecorp.com/banner.jpg",
                    "primaryColor": "#0066CC"
                },
                "security": {
                    "role": "org.admin"
                },
                "configuration": {
                    "storageProvider": {
                        "id": "698f42e5457fafa13d088795",
                        "name": "AWS S3 US East",
                        "region": "us-east-1",
                        "config": "s3-standard",
                        "provider": "aws"
                    },
                    "notificationLanguage": "en",
                    "required2FADashboard": true,
                    "required2FAStore": false,
                    "noReplyAlias": "[email protected]",
                    "buildPlatforms": [
                        "ios",
                        "android",
                        "windows"
                    ],
                    "sdkExtraBuildPlatforms": [
                        "macos",
                        "windows"
                    ],
                    "denyTraditionalAccess": false,
                    "buildRetentionDays": 90,
                    "buildsRetainedPerPublication": 5,
                    "showDeviceNetworkLocation": true
                },
                "blocked": false,
                "blockedReason": "",
                "trialIniDate": null,
                "trialEndDate": null,
                "lastPlan": "enterprise-annual",
                "billingReason": "subscribe",
                "lastActivityDate": "2024-01-01T00: 00:00Z",
                "createdBy": "698f42e5457fafa13d088799",
                "createdAt": "2026-01-15T10: 00:00Z",
                "updatedAt": "2026-02-13T14: 30:00Z"
            }
        ],
        "totalDocs": 0,
        "limit": 0,
        "hasPrevPage": true,
        "hasNextPage": true,
        "page": 0,
        "totalPages": 0,
        "prevPage": 0,
        "nextPage": 0,
        "lean": true
    }
}

400 Response application/json

status boolean optional

false

error object optional

code number optional

6002

message string optional

Body Validation Error

{
    "status": false,
    "error": {
        "code": 5004,
        "message": "User is not member of any organization"
    }
}

401 Response application/json

status boolean optional

false

error object optional

code number optional

4004

message string optional

Invalid Token

{
    "status": false,
    "error": {
        "code": 4002,
        "message": "No auth token"
    }
}