---
title: Reference
url: https://docs.kaltura.com/docs/rich-media-cms-apis/analytics/analytics-reference
---

## Error Handling & Permissions

### Analytics Permissions

| Permission | ID | Description |
|------------|-----|-------------|
| `ANALYTICS_BASE` | 1085 | Gate for all analytics views |
| `FEATURE_NEW_ANALYTICS_TAB` | 1125 | New analytics dashboard |
| `FEATURE_LIVE_ANALYTICS_DASHBOARD` | 1128 | Live analytics dashboard access |
| `FEATURE_MULTI_ACCOUNT_ANALYTICS` | 1130 | Multi-account (cross-account) analytics |
| `FEATURE_LIVE_STREAM` | 1104 | Required alongside ANALYTICS_BASE for live |
| `FEATURE_END_USER_REPORTS` | 1096 | End-user level reporting |

### Common Errors

| Error Code | Cause | Resolution |
|------------|-------|------------|
| `INVALID_KS` | Expired or malformed session | Generate a new KS |
| `SERVICE_FORBIDDEN` | KS role lacks `ANALYTICS_BASE` | Assign analytics permissions to the role |
| `REPORT_NOT_FOUND` | Invalid `reportType` value | Use a valid integer ID from [Report Types Reference](/docs/rich-media-cms-apis/analytics/analytics-report-types) |
| `INVALID_PARAMS` | Missing required filter fields | Include `fromDate` and `toDate` at minimum |

### Reports Microservice Errors

The Reports Microservice returns HTTP status codes. A `report/serve` call with `statusOnly: true` returns `{"status": "pending"}`, `{"status": "in_progress"}`, or `{"status": "completed"}`. If generation fails, the status response includes an error message.

### Related Guides

- **[Session Guide](/docs/getting-started/authentication/ks-overview)** — `appId:<name>` KS privilege tags analytics per-application; `userId` ties analytics to a user
- **[AppTokens](/docs/getting-started/authentication/app-tokens-overview)** — Scoped tokens for analytics-only access
- **[Player Embed](/docs/embeddable-kaltura-products/kaltura-player/player-embed-overview)** — Player v7 fires ~45 playback events that feed analytics automatically
- **[Upload & Ingestion](/docs/rich-media-cms-apis/content-management/upload-ingestion-overview)** — `baseEntry.exportToCsv` for bulk content export
- **[Webhooks](/docs/rich-media-cms-apis/integration/webhooks)** — Trigger automated reporting on content events
- **[Distribution](/docs/rich-media-cms-apis/integration/distribution)** — Distribution status tracking via analytics reports