# Audicin for Apps API

**Audicin for Apps API Authentication (REQUIRED)**

All Audicin for Apps API  endpoints require the `X-API-KEY` header.

Example:
```
X-API-KEY: xxxxxxxxx
```

Common error responses:
- 401 → Missing or invalid API key
- 402 → Subscription inactive / expired
- 403 → License missing or quota exceeded
- 404 → Resource not found


Version: 1.0.0
License: Proprietary License

## Servers

Generated server url
```
https://dev.api-b2b.audicin.com/api/v1
```

## Security

### api-key

Type: apiKey
In: header
Name: X-API-KEY

## Download OpenAPI description

[Audicin for Apps API](https://partner.audicin.com/_bundle/apis/b2b_portal_documentation.yaml)

## Artists

Fetch artist metadata

### List artists in catalogue

 - [GET /tenants/artists](https://partner.audicin.com/apis/b2b_portal_documentation/artists/getallartists.md): Returns a paginated list of artists available in the Audicin catalogue.

Supports optional filtering by artist first name and/or last name. This endpoint is commonly used for catalogue browsing, search, and artist discovery features.

### Fetch artist details

 - [GET /tenants/artists/{artistId}](https://partner.audicin.com/apis/b2b_portal_documentation/artists/getartist.md): Returns detailed information about a specific artist available in the Audicin catalogue.

This endpoint is typically used to display artist profile pages, artist credits, or contextual information linked from songs.

## Licenses

Fetch license data

### List tenant licenses

 - [GET /tenants/myLicenses](https://partner.audicin.com/apis/b2b_portal_documentation/licenses/getlicenses.md): Returns a paginated list of licenses owned by the authenticated tenant. Results can be filtered by song and license validity.

- When onlyValidNow=true, only currently active licenses are returned.
- When onlyValidNow=false, historical licenses are also included.

This endpoint is typically used to display license usage, quota tracking, and compliance status in the developer dashboard.

### Check license access for a song

 - [GET /tenants/myLicenses/check-access](https://partner.audicin.com/apis/b2b_portal_documentation/licenses/checklicenseforsong.md): 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.

## Categories

Fetch category data

### List available song categories

 - [GET /tenants/categories](https://partner.audicin.com/apis/b2b_portal_documentation/categories/getallcategories.md): Returns a paginated list of song categories available to the tenant. Categories are used to organize and filter the music catalogue (e.g. genres, moods, or classification groups).

This endpoint is typically used to populate filters, dropdowns, or navigation elements in the catalogue UI.

## Streaming

Generate presigned URLs for audio previews and full audios

### Generate presigned preview audio URL

 - [GET /tenants/stream/songPreview/{songPreviewId}](https://partner.audicin.com/apis/b2b_portal_documentation/streaming/streampreviewaudio.md): Returns a presigned GET URL for a song preview

### Generate presigned download URL

 - [GET /tenants/stream/song/{songId}](https://partner.audicin.com/apis/b2b_portal_documentation/streaming/streamsongaudio.md): Returns a presigned GET URL

## Songs

Fetch song data and metadata

### List available songs in catalogue

 - [GET /tenants/songs](https://partner.audicin.com/apis/b2b_portal_documentation/songs/getallsongs.md): Returns a paginated list of songs from the Audicin catalogue that are visible to the authenticated tenant. Supports filtering by title and genre. Song availability does not imply licensing or streaming rights.

### Get song details from catalogue

 - [GET /tenants/songs/{songId}](https://partner.audicin.com/apis/b2b_portal_documentation/songs/getsong.md): 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.

## Media

Fetch media data

### Get image download URL by ID

 - [GET /tenants/downloadable/images/{mediaId}](https://partner.audicin.com/apis/b2b_portal_documentation/media/getimagedownloadurl.md): Returns a presigned download URL for image media for song cover or artist avatar