8x8 Analytics for Work API Error: Cannot Access Analytics Data 400 Bad Request Insufficient Permissions

8x8 Analytics for Work API Error: Cannot Access Analytics Data 400 Bad Request Insufficient Permissions

Symptom

When attempting to retrieve call data records (CDR) via the API, a 400 Bad Request error is received with the following message: "user({userName}) does not have access to api category(CDR) for pbxId([{pbxName}])." The error code associated with this issue is 105-400-038.

Applies To

  • 8x8 Analytics for Work API

Resolution

To resolve this issue, the following steps need to be taken:

  1. Licence Verification: Ensure that the user account being used to authenticate the API request has been assigned a licence that includes access to the 8x8 Analytics features.
  2. Access Level Verification: Confirm that the user account being used to authenticate the API request has been granted Analytics: Supervisor access to 8x8 Analytics for Work; this can be found in Admin Console, Users, Edit, Analytics for 8x8 Work, Allowed access level.

Once both the correct license and access level have been provisioned for the user account, the API requests for call data records should be successful.

Cause

This error indicates that the account used to authenticate the API request does not have the necessary permissions to access the CDR data for the PBX.

The user requires an appropriate license that includes access to 8x8 Analytics features and supervisor-level access within the 8x8 Analytics for Work.

Additional Information

It is recommended that the user's access within the 8x8 Analytics for Work User Interface be verified to confirm that the user's requirement for a license with analytics access and supervisor privileges aligns with the necessary permissions to interact with the CDR data through the API.

See more information on the 8x8 Developer Hub, Call Detail Records.

    • Related Articles

    • Analytics for Work Data Retention Enforcement

      Overview This FAQ addresses common questions regarding the enforced data retention policy for 8x8 Analytics for Work historical data. As part of this policy, access to Analytics for Work data older than two years will no longer be available. Applies ...

    • Authentication to Use Analytics for 8x8 Work API

      Objective Analytics for 8x8 Work API authentication. Applies To Analytics for 8x8 Work APIs Procedure Open Admin Console from your 8x8 Application Panel and navigate to API Keys icon. Click on Create App button Select Analytics for 8x8 Work and input ...

    • Enable Extensions for Analytics for 8x8 Work

      Objective Enable extensions to use Analytics for 8x8 Work in Admin Console. Applies To Admin Console Extensions Analytics for 8x8 Work 8x8 Work X Series Licenses with Analytics: Essentials: X1 and above 8x8 Work X Series Licenses with Analytics: ...

    • Log in to Analytics for 8x8 Work

      Objective Log in to Analytics for 8x8 Work to obtain analytics, not limited to: Access call logs through 8x8 Work Access call history for 8x8 Work extensions 8x8 Work user's activity Applies To Analytics for 8x8 Work Admin Console User Permissions ...

    • Generate an API Key for Analytics for 8x8 Work API

      Objective Generating an API Key for Analytics for 8x8 Work reporting. Applies To Analytics for 8x8 Work Procedure System administrators can now generate API keys from 8x8 Admin Console. For a detailed explanation, see the 8x8 Developer Hub: How to ...