Favicon

You are here: Home > API Reference > Platform > Organization > List accessible organization workspaces

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

GET
https://api.applivery.io/v1/organizations 
curl -X GET "https://api.applivery.io/v1/organizations" \
  -H "Authorization: Bearer <YOUR_API_KEY>"
const response = await fetch("https://api.applivery.io/v1/organizations", {
  method: "GET",
  headers: {
    Authorization: "Bearer <YOUR_API_KEY>",
  },
});

const data = await response.json();
import requests

response = requests.get(
    "https://api.applivery.io/v1/organizations",
    headers={"Authorization": "Bearer <YOUR_API_KEY>"},
)

data = response.json()

Request

Send your API key in the request 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-z0-9][a-z0-9-]+[a-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.
loginProviders object optional
Authentication provider configurations defining allowed login methods for dashboard store and MDM portal access security.
limits object optional
Resource quota limits derived from active subscription defining maximum allowed applications builds downloads and devices.
allows object optional
Feature capability flags derived from subscription indicating which advanced features are enabled for workspace.
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.
store object optional
Application store configuration settings defining custom domain and employee access portal customization.
branding object optional
Visual identity customization settings including logo images and color schemes for white-label workspace presentation.
security object optional
Security context for authenticated user including access role and permission level within workspace.
configuration object optional
Organization operational settings with storage provider details and complete feature configuration policies.
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,
                    "aospMdm": 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"
    }
}