Insufficient Scope Error (trapi.data.research.read) When Accessing Research API via Java REST Reques

User: "neklans"
Newcomer
Updated by Jirapongse

We are developing a Java application to programmatically download Initiation reports for specific companies using the Refinitiv Research API via REST requests. However, we are encountering a permission error indicating insufficient scope when attempting to access certain endpoints.

Problem Details:

  1. Objective: Download Initiation reports (e.g., PDF documents) for specific companies using the Research API.
  2. Endpoint Example:
    • URL: https://api.refinitiv.com/data/research/v1/documents/84269904/pdf?uuid=GENTC-185510
    • Response:jsonCopy{ "error": { "id": "42b7d198-f92c-4ceb-8c8a-4c0b0eab894c", "code": "insufficient_scope", "message": "access denied. Scopes required to access the resource: [trapi.data.research.read]. Missing scopes: [trapi.data.research.read]", "status": "Forbidden" }}
  3. API Playground: We also tested the endpoint in the API Playground and received a similar "insufficient scope" error, confirming the permission issue.
  4. Current Permissions: Our account has access to the following API types: Side by Side API, EDP API, and Eikon Data API. The access token is generated with the scope trapi.

Code Snippet:

  • Authentication:
    HttpPost post = new HttpPost("https://api.refinitiv.com/auth/oauth2/v1/token");
    post.setHeader("Content-Type", "application/x-www-form-urlencoded");
    String body = String.format(
    "grant_type=password&username=%s&password=%s&client_id=%s&scope=trapi",
    USERNAME, PASSWORD, CLIENT_ID);
    // Execute request to obtain access token


  • API Request:
    HttpGet get = new HttpGet("https://api.refinitiv.com/data/research/v1/documents/84269904/pdf?uuid=GENTC-185510");
    get.setHeader("Authorization", "Bearer " + accessToken);
    // Execute request, results in 403 Forbidden

Questions:

  1. Does our account need additional permissions or a specific license to access the trapi.data.research.read scope for the Research API?
  2. If additional permissions are required, how can we verify or request access to this scope?
  3. Are there specific configurations or parameters (e.g., scope values) we need to include in the authentication request to access the Research API?
  4. Are there alternative endpoints or methods to programmatically download Initiation reports that align with our current permissions?
Sort by:
1 - 1 of 11

    Hello @neklans

    The Data Platform is a collection of services and users can be entitled to a single service or a group of services via a bundled package. The error message:

    "insufficient_scope", "message": "access denied. Scopes required to access the resource:

    indicates that your account does not have permission to access Research Reports. Please reach out to your LSEG account manager to signup for these additional products.