GET /asset

Retrieve full metadata and tags for a specific audio asset by its ID.

Request

GET /asset?id=<assetId>

Parameters

Parameter	Type	Description
`id`	`number`	The ID of the asset to retrieve

Response

Returns a single asset object including all embedded metadata, physical properties, UCS classification, and tags.

{
  "id": 12345,
  "fileName": "explosion_huge.wav",
  "format": "WAV",
  "duration": 5.4,
  "sampleRate": 48000,
  "channels": 2,
  "bitrate": 2304000,
  "bitDepth": 24,
  "fileSize": 3110400,
  "bpm": null,
  "title": "Huge Cinematic Explosion",
  "artist": "Sound Designer",
  "genre": "Cinematic",
  "comment": "Great for trailers",
  "albumTitle": null,
  "grouping": null,
  "additionalMetadata": "...",
  "dateAdded": "2026-04-18T10:30:00Z",
  "isFavorite": true,
  "ucsCatID": "EXPLReal",
  "ucsFxName": "Explosion Huge",
  "ucsCreatorID": "StudioX",
  "ucsSourceID": "Action Pack Y",
  "ucsUserCategory": null,
  "ucsVendorCategory": null,
  "ucsUserData": null,
  "tags": ["Action", "Sci-Fi", "Trailer"]
}

Response Fields

Field	Type	Description
`id`	`number`	Unique identifier for the audio asset
`fileName`	`string`	File name
`format`	`string`	Audio format (e.g., `"WAV"`, `"FLAC"`)
`duration`	`number`	Length in seconds
`sampleRate`	`number`	Sample rate in Hz (e.g., `44100`, `48000`)
`channels`	`number`	Number of audio channels
`bitrate`	`number`	Bitrate in bps
`bitDepth`	`number`	Bit depth (e.g., `16`, `24`). Optional.
`fileSize`	`number`	File size in bytes
`bpm`	`number \| null`	BPM if detected or embedded, otherwise `null`
`title`	`string \| null`	Title metadata field
`artist`	`string \| null`	Artist metadata field
`genre`	`string \| null`	Genre metadata field
`comment`	`string \| null`	Comment / description metadata field
`albumTitle`	`string \| null`	Album title metadata field
`grouping`	`string \| null`	Grouping metadata field
`additionalMetadata`	`string \| null`	Base64-encoded string of any extra raw JSON metadata
`dateAdded`	`string`	ISO 8601 timestamp of when the file was added to the library
`isFavorite`	`boolean`	Whether the file is marked as a favorite
`ucsCatID`	`string \| null`	UCS Category ID
`ucsFxName`	`string \| null`	UCS FxName
`ucsCreatorID`	`string \| null`	UCS CreatorID
`ucsSourceID`	`string \| null`	UCS SourceID
`ucsUserCategory`	`string \| null`	UCS UserCategory
`ucsVendorCategory`	`string \| null`	UCS VendorCategory
`ucsUserData`	`string \| null`	UCS UserData
`tags`	`string[]`	Array of assigned tag names