---
title: "Get a song: status, then the full analysis"
method: GET
path: "/songs/{song_id}"
tags: ["Songs"]
---

# Get a song: status, then the full analysis

`GET /songs/{song_id}`

## Request

- Base URL: `https://api.songbrain.ai/v1`
- URL: `https://api.songbrain.ai/v1/songs/{song_id}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Path parameters

- `song_id` string, required

## Query parameters

- `view` string
- `include` string, nullable: Comma list of sections, e.g. song_dna,shot_plan

## Response `200`

Successful Response

- unknown

## Other responses

- `400`: Invalid request (bad JSON, missing audio, invalid parameters).
- `401`: Missing or invalid API key.
- `402`: Free songs used up and not enough credits.
- `404`: Not found on your account.
- `409`: Conflict (still processing, Idempotency-Key reused or in progress).
- `413`: Audio larger than 100 MB.
- `415`: Unsupported content type.
- `429`: Rate limited or pipeline busy; see Retry-After.
- `500`: Server error. Quote the request_id when you contact support.

---

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