Authenticate and access the Statistics Reporting API
This topic explains how to authenticate, what roles or permissions are required, and how to access the API with proper authorization headers.
Use authentication to securely access the Statistics Reporting Services API. All requests must include authorized headers and are subject to access controls based on the tenant and role associated with the access token.
Access control and permissions
The API is protected behind the Reltio API Gateway. It is accessible only to users or systems that are authenticated and authorized to perform reporting operations for a specific tenant.
- A valid bearer token must be included in the Authorization header
- The token must be associated with a user or system that has the
ROLE_STATISTICS_REPORTINGpermission - Access is limited to the tenant specified in the token
Request headers
The following request headers must be included when calling the Statistics Reporting Services API.
| Header name | Description |
|---|---|
| Authorization | Required bearer token (for example, Bearer {access_token}) |
| Content-Type | Must be set to application/json for POST requests |
Example usage
curl -X GET https://{gateway-url}/statistics-reporting/{tenantId}/API/getTenantStats \
-H "Authorization: Bearer {access_token}" \
-H "Content-Type: application/json"
Error behavior
If the request is missing the Authorization header, lacks the required role, or contains an invalid token, the API responds with an error. The response typically includes an HTTP 401 Unauthorized or 403 Forbidden status, depending on the nature of the failure.