---
title: "Report usage in bulk"
method: POST
path: "/v0/analytics/report"
tags: ["Reporting"]
---

# Report usage in bulk

`POST /v0/analytics/report`

This endpoint should be used when you want to bulk report events to Epidemic Sound. We currently support the following events:
trackPreviewed, trackDownloaded and tracksExported. Note that the limit for number of events per request is limited to 100.
 Also note that for events containing the field trackIds, the limit for number of trackIds per event is 50. 
 Events may not contain a timestamp older than 7 days ago.

## Request body

- AnalyticsReportRequest
  - `events` AnalyticsReportEvent[], required
    - `userId` string
    - `timestamp` string, date-time
    - `userConnected` boolean, nullable
    - `analyticsEvent` union
      - object
        - `trackId` string
        - `type` 'trackPreviewed'
      - object
        - `trackId` string
        - `format` 'mp3' | 'hls' | 'hls_with_cookie'
        - `quality` 'normal' | 'high'
        - `type` 'trackDownloaded'
      - object
        - `trackIds` string[]
        - `platform` 'YOUTUBE' | 'TWITTER' | 'TWITCH' | 'FACEBOOK' | 'INSTAGRAM' | 'TIKTOK' | 'OTHER' | 'LOCAL'
        - `type` 'tracksExported'

## Response `200`

Usage report response

- AnalyticsReportResponse
  - `batchId` string, required
  - `eventsCount` integer, required

## Other responses

- `400` — Bad request.
- `401` — Unauthorized. Most likely your access token has expired.
- `429` — Rate limit exceeded.

---

[API](https://skmtc.net/epidemicsound/apis/partner-content-api.md) · [All operations](https://skmtc.net/epidemicsound/apis/partner-content-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/epidemicsound/partner-content-api/revisions/c11d2a3e0d84/schema)