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:
- Objective: Download Initiation reports (e.g., PDF documents) for specific companies using the Research API.
- 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" }}
- API Playground: We also tested the endpoint in the API Playground and received a similar "insufficient scope" error, confirming the permission issue.
- 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:
- Does our account need additional permissions or a specific license to access the trapi.data.research.read scope for the Research API?
- If additional permissions are required, how can we verify or request access to this scope?
- Are there specific configurations or parameters (e.g., scope values) we need to include in the authentication request to access the Research API?
- Are there alternative endpoints or methods to programmatically download Initiation reports that align with our current permissions?
