---
title: "Preview sound effect"
method: GET
path: "/v0/sound-effects/{soundEffectId}/preview"
tags: ["Sound effects"]
---

# Preview sound effect

`GET /v0/sound-effects/{soundEffectId}/preview`

## Request

- Base URL: `https://partner-content-api.epidemicsound.com`
- URL: `https://partner-content-api.epidemicsound.com/v0/sound-effects/{soundEffectId}/preview`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://login.epidemicsound.com/auth/realms/accounts/protocol/openid-connect/auth`
    - Token URL: `https://login.epidemicsound.com/auth/realms/accounts/protocol/openid-connect/token`
  - HTTP bearer

The preview endpoint gives you a link to a normal quality (128kbps) MP3 of the sound effect, so users can listen to it before downloading. Browsers start playing the file before it has finished loading.

Previews are not downloads. They count towards your stream quota, like track streams, and not towards your download quota or download statistics. To use a sound effect in content, download it with the download endpoint.

The preview link expires after 1 hour. Request a new link each time a user plays a sound effect, and don't store it.

## Path parameters

- `soundEffectId` string, uuid, required

## Response `200`

Information about the preview url

- DownloadResponse
  - `url` string, required
  - `expires` string, required

## Other responses

- `400`: Bad request.
- `401`: Unauthorized. Most likely your access token has expired.
- `402`: The workspace has used up its stream quota. Previews count towards the stream quota.
- `404`: Sound effect was not found.
- `429`: Rate limit exceeded.

## Changes

- **2026-10-20** `5ef4d0e16278`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/epidemicsound/apis/partner-content-api/changes/v0/sound-effects/:soundEffectId/preview/get.md)

---

[API](https://skmtc.dev/epidemicsound/apis/partner-content-api.md) - [All operations](https://skmtc.dev/epidemicsound/apis/partner-content-api/llms.txt) - [OpenAPI document](https://skmtc.dev/epidemicsound/apis/partner-content-api/revisions/5ef4d0e16278?raw)