Common

The Common Lookup API provides access to predefined metadata such as languages, music styles (genres), distribution stores, currencies, and more. These lookups help standardize data across the platform.

API Endpoints

• Get all lookup data:

  GET /common/lookup
  Host: api.audicient.com

• Get specific lookup data:

  GET /common/lookup/{category}
  Host: api.audicient.com

  Example:

  GET /common/lookup/languages

Authentication Requirements

Some endpoints, such as distributionStores, require authentication. If accessing these endpoints for a user, include the enterprise-id header.

Example request with authentication:

GET /common/lookup/distributionStores
Host: api.audicient.com
Authorization: <API_KEY>:<API_SECRET>
enterprise-id: 123456

Supported Categories

• languages

• musicStyles

• musicContributors

• publishingContributors

• currencies

• countries

• releaseTypes

• distributionStores

• priceTiers

• timezoneIds

Response Examples

Countries

{
  "iso2Code": "US",
  "code": "USA",
  "name": "United States",
  "countryId": 244
}

Currencies

{
  "code": "USD",
  "symbol": "$",
  "name": "United States Dollar",
  "countryCode": "USA"
}

Timezones

{
  "text": "International Date Line West",
  "timezoneId": 1
}

Release Types

{
  "releaseTypeId": 1,
  "name": "Album"
}

Music Styles

{
  "musicStyleId": 292,
  "name": "African",
  "parentId": null,
  "order": 0
}

Languages

{
  "languageId": 1,
  "name": "English",
  "languageCode": "en",
  "isValidMetadataLanguage": true
}

Price Tiers

{
  "priceTierId": 18,
  "name": "Back",
  "code": 98,
  "isForRelease": false,
  "isForTrack": true,
  "price": 0.69,
  "distributorStoreId": 1,
  "order": 1
}

Distribution Stores

{
  "distributorStoreId": 1,
  "name": "iTunes/Apple Music + Shazam",
  "isActive": true,
  "shortDescription": null,
  "display": true,
  "supportRingtones": true,
  "supportVideos": false,
  "isNew": null
}

Music Contributors

{
  "roleId": 49,
  "name": "Primary Artist",
  "priority": 1
}

Publishing Contributors

{
  "roleId": 2,
  "name": "Composer",
  "priority": 5
}

Use these endpoints to retrieve structured metadata for your application.