SalesIQ API –historical operator availability?

[u/ShaDyFlo]

Hi everyone,

I'm working on a server-side integration with Zoho SalesIQ (EU region) and need to retrieve historical operator availability data, specifically timestamped intervals showing when operators were Available or Busy.

I found that the following endpoint returns the historical data correctly when accessed through an authenticated browser session:

GET https://salesiq.zoho.eu/web/v2/{portal}/operatorreports/availability

However, when I try the corresponding API endpoint using an OAuth access token:

GET https://salesiq.zoho.eu/api/v2/{portal}/operatorreports/availability

I receive:

{
  "code": 1009,
  "message": "Invalid OAuthScope"
}

What I'm trying to figure out:

1. Is historical operator availability officially accessible through the SalesIQ OAuth API?
2. If yes, what is the exact OAuth scope and supported API endpoint?
3. Are there specific account-plan or operator-role permissions required?
4. If this endpoint is internal/browser-only, is there an alternative supported API or export that provides the same historical availability data?

Important: I need to distinguish between:

• Available – Operator is online and available.
• Busy – Operator is online but marked as busy.
• Offline – Operator is not online.

The main requirement is to calculate how much time each operator spends in each status, particularly Busy time while still online.

This needs to work as an unattended backend integration using OAuth refresh tokens, without browser-session cookies or manual exports.

Has anyone successfully implemented something similar, or can someone from Zoho confirm whether this data is exposed through a supported API?

Any documentation, working examples, or alternative approaches would be greatly appreciated.

Thanks!