---
title: "Read the waveform of a file uploaded for a free run"
method: GET
path: "/api/try/files/{id}/peaks"
tags: ["Free API"]
---

# Read the waveform of a file uploaded for a free run

`GET /api/try/files/{id}/peaks`

## Request

- Base URL: `https://audo.ai`
- URL: `https://audo.ai/api/try/files/{id}/peaks`
- Auth: none required

t is the file's fileToken from POST /api/try/uploads. Otherwise as GET /api/v1/files/{id}/peaks.

## Path parameters

- `id` string, required

## Query parameters

- `t` string, required
- `wait` number
- `level` 5 | 50 | 500
- `first` integer
- `count` integer

## Response `200`

OK

- object
  - `fileId` string, required
  - `status` 'processing' | 'ready' | 'none', required: processing while they're made (ask again, with wait); none when the file has no sound to draw
  - `durationSeconds` number, nullable, required: How long the decoded sound is
  - `peak` number, nullable, required: The loudest sample, 0 to 1
  - `levels` object[], required
    - `perSecond` integer, required
    - `count` integer, required
  - `bins` object, nullable, required: The bins asked for with level, first, and count, once ready
    - `level` integer, required
    - `first` integer, required
    - `count` integer, required
    - `data` string, required: Base64 of count pairs of signed bytes: min, then max

## Other responses

- `default`: An error, with what went wrong and what to do next

---

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