---
title: "Gets the waveform peaks for a track"
method: GET
path: "/tracks/{track_id}/waveform"
tags: ["tracks"]
---

# Gets the waveform peaks for a track

`GET /tracks/{track_id}/waveform`

## Request

- Base URL: `https://api.audius.co/v1`
- URL: `https://api.audius.co/v1/tracks/{track_id}/waveform`
- Auth: none declared

Amplitude envelope precomputed by content nodes. 404 when no node has computed one for this track.

## Path parameters

- `track_id` string, required

## Response `200`

Success

- TrackWaveformResponse
  - `data` TrackWaveform
    - `duration_ms` integer, required
    - `buckets` integer, required
    - `peaks` integer[], required: Amplitude per bucket, 0-255, scaled to the track's own peak

## Other responses

- `400`: Bad request
- `404`: No waveform for this track
- `500`: Server error

## Changes

- **2026-11-06** `d5ef170f214a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/audius/apis/audius-api/changes/tracks/:track_id/waveform/get.md)

---

[API](https://skmtc.dev/audius/apis/audius-api.md) - [All operations](https://skmtc.dev/audius/apis/audius-api/llms.txt) - [OpenAPI document](https://skmtc.dev/audius/apis/audius-api/revisions/c12f26816524?raw)