Retrieves all configuration profiles along with their basic metadata and publish status.
https://{serverurl}/bsp/api/v1/bmp/profiles
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Filter profiles by name (contains match). Example: 'corporate', 'finance', 'security'
Filter by published status. Values: true (only published/active profiles), false (only draft profiles)
Filter by profile type ID. Comma-separated for multiple types. Common values: 64005 (Browser Customization), 64600 (Security), 64700 (Privacy), 64800 (Download Filter), 64900 (Upload Filter), 64950 (URL Filter). Example: '64005' or '64005,64600'
Max results per page. Example: 50, 100, 200
Starting index for results (0-based). Example: 0, 50, 100
Cursor-based pagination token returned from previous response for fetching next page
Platform filter. Values: '1' (Windows only), '2' (Mac only), '-1' (all platforms)
Filter by trash status. Values: true (only trashed/deleted profiles), false (only active profiles, default)
curl --request GET \
--url https://appdomains/bsp/api/v1/bmp/profiles \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'List of configuration profiles
Configuration profiles with name, type, status, platform, and browser details
Summary of a configuration profile in a list response
Profile ID
Display name
Profile type code. See profileDetailResponse.profile_type
'1'=Windows, '2'=Mac, '-1'=All platforms (Windows + Mac)
'110'=Published, '1'=Draft
Pagination. Contains 'next' URL with skip-token when more results exist
Bad request error for invalid input or constraint violations
Error code identifying the specific validation failure
Message describing the validation failure
Unauthorized error code: credentials missing, expired, or invalid
Authentication failure reason
Error code indicating insufficient permissions
Message indicating insufficient privileges to access this resource
Rate limit error code returned when the API call reached threshold
Rate limit exceeded message with retry guidance
Internal server error response for profile operations
Error message describing the server failure
Error code for internal server errors
List of configuration profiles with pagination
{
"profiles": [
{
"platform_type": "1",
"profiletype": "64960",
"profilestatus": "1",
"profileid": "111",
"profilename": "ManagedbrowserPolicy 15"
},
{
"platform_type": "1",
"profiletype": "64200",
"profilestatus": "1",
"profileid": "111",
"profilename": "ThreatPreventionPolicy 19"
}
],
"paging": {
"next": "<server-url>/api/v1/bmp/profiles?skip-token=NTA6NTE6MToxNzc2MTY1MDg0Nzk3"
}
}
No matching profiles found
{
"profiles": []
}
Pagination parameters out of allowed range
{
"errorcode": "IAM0003",
"errormsg": "Invalid request."
}
API key is missing or invalid
{
"errorCode": "IAM0001",
"errorMsg": "Authentication key is invalid. Please regenerate the key and try again."
}
Forbidden
{
"errorCode": "FORBIDDEN",
"errorMsg": "User does not have permission to perform this operation"
}
Rate limit exceeded
{
"errorCode": "RATE_LIMIT_EXCEEDED",
"errorMsg": "Too many requests. Please try again after 5 minutes"
}
Server error
{
"error_description": "Internal Server error, Please try again in a moment.",
"error_code": "COM0004"
}
![]()
Duration: 1 minute | Threshold: 60 | Lock period: 5 minutes
Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.