Retrieves all configured native messaging hosts.
get /bsp/api/v1/bmp/nativehost
https://{server-hostname}:8383/bsp/api/v1/bmp/nativehost Copied!
Authorization: d92d4xxxxxxxxxxxxx15f52
Search string to filter native hosts by URL or hostname (contains match). Example: 'com.company', 'chrome.extension', 'messaging'
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
curl --request GET \
--url 'https://appdomain/bsp/api/v1/bmp/nativehost?search_bsp=SOME_STRING_VALUE&limit=SOME_INTEGER_VALUE&offset=SOME_INTEGER_VALUE&skip-token=SOME_STRING_VALUE' \
--header 'Accept: application/json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52'Native messaging hosts configured for browser communication, showing their ID and hostname
Unique identifier for the native messaging host
Native messaging host identifier string (e.g., com.example.nativehost)
Unique identifier for the native messaging host
Native messaging host identifier string (e.g., com.example.nativehost)
Message indicating the requested range limit is out of the allowed range
Error code identifying the type of bad request
Unauthorized error code: API key or OAuth token missing, expired or invalid
Authentication failure reason
Forbidden error code: the user lacks the required MDM_OSUpdateMgmt UEM role
Message indicating insufficient privileges
Rate limit error code: API call threshold exceeded for this endpoint group
Rate limit exceeded message with retry guidance
Message describing the internal server error
Error code identifying the type of server error
All hosts
{
"native-hosts": [
{
"name": "com.example.nativehost",
"id": "1"
},
{
"name": "com.google.chrome.remote",
"id": "2"
}
]
}
Paginated result with next page link
{
"native-hosts": [
{
"name": "com.example.nativehost",
"id": "1"
}
],
"paging": {
"next": "<server-url>/api/v1/bmp/nativehost?skip-token=eyJ0eXBlIjoic2tpcCJ9"
}
}
Search filter
{
"native-hosts": [
{
"name": "com.google.chrome.remote",
"id": "2"
}
]
}
Limit out of range
{
"error_description": "Range limit exceeded. Maximum allowed: 1000",
"error_code": "ARRAY_SIZE_OUT_OF_RANGE"
}
Unauthorized
{
"errorCode": "UNAUTHORIZED",
"errorMsg": "You are not authorized to perform this action"
}
Forbidden
{
"errorCode": "FORBIDDEN",
"errorMsg": "You do not have permission to access this resource"
}
Rate limit exceeded
{
"errorCode": "RATE_LIMIT_EXCEEDED",
"errorMsg": "You have exceeded the maximum number of API calls. Please try again later."
}
Server error
{
"error_description": "Internal Server error, Please try again in a moment.",
"error_code": "COM0004"
}
![]()
Duration: 1 minute | Threshold: 120 | 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.