Retrieve enterprise details

GET

/v1/organizations/:organizationId/mdm/android/enterprise/

Retrieve enterprise details

Required Permission: mdm.android.enterprise.getByOrganization

Retrieves the EMM enterprise configuration and status for the specified organization.

Request

Add parameter in header authorization

Example: Authorization: Bearer <token>

organizationId string

required

Unique identifier for organization managing Apple enterprise application deployments and configurations.

Match pattern: ^(([a-fA-F0-9]{24})|([a-zA-Z0-9\\-]{3,}))$

Responses

200 Response application/json

status boolean required

data object required

id string required

Unique identifier for the EMM enterprise record enabling cross-reference operations between local database and Google Android Management API resources.

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

config object required

Enterprise configuration object containing Google-synchronized settings for branding, authentication, and operational parameters.

name string optional

Internal enterprise name used for administrative identification within the platform backend systems distinct from user-facing display labels.

≤ 128 characters

enterpriseDisplayName string optional

User-facing enterprise name displayed within Google Play managed configurations interface and enrollment workflows visible to end users.

≤ 256 characters

logo any optional

Enterprise branding logo configuration containing image URL and content hash for visual customization of enrollment and management interfaces.

primaryColor integer optional

Integer representation of primary brand color in ARGB format applied to enrollment screens and management interface elements.

≥ 0 · ≤ 9007199254740991

termsAndConditions array optional

Legal agreements and usage policies presented to users during device enrollment requiring acknowledgment before granting access.

enterpriseType string optional

Google enterprise configuration type indicating operational mode as either customer-managed or EMM-managed affecting ownership and control boundaries.

managedGooglePlayAccountsEnterpriseType string optional

Managed Google Play account type defining user account provisioning model and authentication requirements for application distribution workflows.

managedGoogleDomainType string optional

Google domain management type specifying organization's authentication relationship with Google Workspace affecting sign-in policies and account restrictions.

googleAuthenticationSettings any optional

Authentication policy configuration controlling Google account sign-in requirements and restrictions for managed device access.

error string optional

Error code indicating enterprise configuration or synchronization failure requiring administrative intervention for resolution.

unauthorized

_config any optional

Raw enterprise configuration object from Google Android Management API preserved for debugging and advanced troubleshooting scenarios.

adminEmail string optional

≤ 256 characters · Match pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ · Format: email

updatedAt string required

Timestamp recording most recent enterprise configuration modification enabling change tracking and audit trail maintenance.

createdAt string required

Timestamp marking initial enterprise creation providing foundational audit record and enabling lifecycle analysis.

{
    "status": true,
    "data": {
        "id": "string",
        "config": {
            "name": "string",
            "enterpriseDisplayName": "string",
            "logo": "string",
            "primaryColor": 0,
            "termsAndConditions": [
                "string"
            ],
            "enterpriseType": "string",
            "managedGooglePlayAccountsEnterpriseType": "string",
            "managedGoogleDomainType": "string",
            "googleAuthenticationSettings": "string"
        },
        "error": "unauthorized",
        "_config": "string",
        "adminEmail": "[email protected]",
        "updatedAt": "string",
        "createdAt": "string"
    }
}

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"
    }
}

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"
    }
}