# Get song details from catalogue

Fetches detailed metadata for a single song available in the Audicin catalogue for the authenticated tenant. This endpoint does not grant a license or streaming access; it only returns song information.

Endpoint: GET /tenants/songs/{songId}
Version: 1.0.0
Security: api-key

## Path parameters:

  - `songId` (string, required)

## Response 200 fields (application/json):

  - `id` (string)
    Song ULID

  - `title` (string)
    Song title

  - `mainArtist` (object)
    Artist details as returned to the developer portal

  - `mainArtist.id` (string)
    Artist ULID

  - `mainArtist.firstName` (string)
    First name

  - `mainArtist.lastName` (string)
    Last name

  - `mainArtist.description` (string)
    Artist bio/description

  - `mainArtist.avatar` (object)
    Media asset (audio, image) metadata and URL

  - `mainArtist.avatar.id` (string)
    Media ULID

  - `mainArtist.avatar.required` (boolean)
    Whether this media is required

  - `mainArtist.avatar.multiple` (boolean)
    Whether multiple files are allowed

  - `mainArtist.avatar.url` (string)
    Public or presigned URL to access the media

  - `mainArtist.avatar.allowedType` (string)
    Allowed MIME type category
    Enum: "IMAGES", "FILES", "VIDEOS", "AUDIOS"

  - `seconds` (integer)
    Duration in seconds

  - `previewAudio` (object)
    Media asset (audio, image) metadata and URL

  - `coverMedia` (object)
    Media asset (audio, image) metadata and URL

  - `description` (string)
    Song description

  - `categories` (array)
    Categories/genres

  - `categories.id` (string)
    Category ULID

  - `categories.name` (string)
    Category name (e.g. genre)

  - `categories.type` (string)
    Category type
    Enum: "main", "secondary"

  - `artists` (array)
    All contributing artists

## Response 400 fields (application/json):

  - `errorCode` (string)

  - `error` (string)
    e.g. Validation Failed

  - `title` (string)
    e.g. Invalid Parameter

  - `message` (string)

  - `details` (string,null)

  - `validationErrors` (object)

## Response 402 fields (application/json):

  - `errorCode` (string)

  - `title` (string)

  - `message` (string)

  - `ref` (string,null)

  - `validationErrors` (object)

## Response 404 fields (application/json):

  - `errorCode` (string)

  - `title` (string)

  - `message` (string)

  - `ref` (string,null)

  - `validationErrors` (object)

## Response 500 fields (application/json):

  - `errorCode` (string)

  - `title` (string)

  - `message` (string)

  - `ref` (string,null)

  - `validationErrors` (object)