You are here: Home > API Reference > UEM > Configurations > Retrieve MDM configurations

Retrieve MDM configurations

Required Permission: mdm.global.configurations.get

Returns the MDM integration credentials and settings for the organization.

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

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

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

data = response.json()

Request

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

organizationId string
required
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
MDM configurations unique identifier used for database references, API responses, and internal system operations throughout the platform.
Match pattern: ^[a-fA-F0-9]{24}$
organizationId string required
Organization unique identifier linking MDM configurations to the owning workspace for access control and resource isolation.
Match pattern: ^[a-fA-F0-9]{24}$
entraId object required
Microsoft Entra ID integration settings containing credentials required to authenticate against Microsoft Graph API for device compliance sync.
tenantId string required
Microsoft Entra ID tenant identifier representing the Azure Active Directory directory used for authentication and device management.
≤ 256 characters
clientId string required
Application client identifier registered in Microsoft Entra ID granting access to Microsoft Graph API on behalf of the organization.
≤ 256 characters
clientSecret string optional
Application client secret used to authenticate against Microsoft Entra ID. Always masked in API responses for security purposes.
≤ 256 characters
updatedAt string required
Timestamp of the most recent update to the MDM configurations record reflecting the last modification date and time.
createdAt string required
Timestamp indicating when the MDM configurations record was first created in the system.
{
    "status": true,
    "data": {
        "id": "string",
        "organizationId": "string",
        "entraId": {
            "tenantId": "string",
            "clientId": "string",
            "clientSecret": "string"
        },
        "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"
    }
}
Was this page helpful?