# Check license access for a song

Checks whether the authenticated tenant has an active or historical license for a specific song. This endpoint is commonly used before attempting playback or streaming.

- When onlyValid=true, only currently active licenses are considered.
- When onlyValid=false, expired or revoked licenses may also be returned.

Endpoint: GET /tenants/myLicenses/check-access
Version: 1.0.0
Security: api-key

## Query parameters:

  - `songId` (string, required)

  - `onlyValid` (boolean)

## Response 200 fields (application/json):

  - `id` (string)
    License ULID

  - `song` (object)
    Summary of a song (id, title, categories, duration)

  - `song.songId` (string)
    Song ULID

  - `song.title` (string)
    Song title

  - `song.categories` (array)
    Categories/genres

  - `song.categories.id` (string)
    Category ULID

  - `song.categories.name` (string)
    Category name

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

  - `song.categories.createdDate` (string)
    Creation timestamp

  - `song.categories.lastModifiedDate` (string)
    Last modified timestamp

  - `song.seconds` (integer)
    Duration in seconds

  - `status` (string)
    License status (ACTIVE, SUSPENDED, REVOKED, EXPIRED)
    Enum: "ACTIVE", "SUSPENDED", "REVOKED", "EXPIRED"

  - `validFrom` (string)
    License valid from (inclusive)

  - `validTo` (string)
    License valid until (inclusive)

  - `createdAt` (string)
    Creation timestamp

## 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)