---
title: "fetch a song by id"
method: GET
path: "/v1/songs?id"
tags: ["Users"]
---

# fetch a song by id

`GET /v1/songs?id`

By passing in the appropriate options, you can search for available inventory in the system

## Query parameters

- `id` string

## Response `200`

search results matching criteria

- SongItem[]
  - `id` number, required
  - `name` string, required
  - `playCount` number
  - `releaseDate` string, date-time
  - `artist` Artist
    - `name` string, required
    - `homePage` string, url
  - `playTimeSecs` number
  - `link` string

## Other responses

- `400` — bad input parameter

## Changes

- **2026-07-17** `be4f64446da3` — 1 info
  - endpoint added
- **2019-01-21** `fa1f348527af` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/packtpublishing/apis/simple-inventory-api/changes/v1/songs?id/get.md)

---

[API](https://skmtc.dev/packtpublishing/apis/simple-inventory-api.md) · [All operations](https://skmtc.dev/packtpublishing/apis/simple-inventory-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/packtpublishing/simple-inventory-api/revisions/be4f64446da3/schema)