Fields and Data Types
Below are all of the resources and fields available through the Easy Song Licensing API. This list shows required fields and data limits, information not found in the reference. Check it out before you post your first request. Know what's needed upfront and avoid validation errors.
List of all available fields with data types and limits
Required fields are flagged with a . Most required fields must be provided upfront when you post a request.
A few special cases are noted with , , and (see the key).
For songs, the original recording artist OR composer is required, but not both. Track length can be provided after the initial post, but must be received for us to clear the request. Expected outlets of distribution is required only when the Interactive Audio Streams format is requested.
Requests contain all of the Licensee, Album, Release, Track, and Song fields, plus the unique Request fields listed. Read-only fields are washed out.
Licensee
ID
UniqueIdentifier
-
ExternalLicenseeID
String
100 char
CompanyName
String
100 char
FormatID
Integer
1001-1011
FormatTitle
String
32 char
ReleaseMonth
Integer
1-12
ReleaseYear
Integer
1753-9999
ReleaseQuantity
Integer
0-2147483647
ExpectedOutletsOfDistribution
String
200 char
QuantityLicensed
Integer
-
Request
CanLicenseCurrently
Boolean
True, False
CanLicenseEver
Boolean
True, False
Description
String
200 char
OriginalRecordingArtist
String
50 char
ComposedBy
String
300 char
ArrangedBy
String
100 char
PublishedBy
String
800 char
LengthInSeconds
Integer
0-2147483647
ExternalTrackID
Integer
100 char
IsPrivate
Boolean
True, False
Key
Required field
Song ComposedBy OR OriginalRecordingArtist is required
Track LengthInSeconds is not initially required, but is required for licensing to proceed
ExpectedOutletsOfDistribution is required for Interactive Audio Streams format only
Expected Outlets of Distribution -
If the Interactive Audio Streams format is requested, we will need to know where the streams will be released. When posting, provide a brief summary of the distribution outlets. Popular choices include CD Baby, Bandcamp, ReverbNation, personal websites, and band pages. If using a distribution package, this can be summarized by naming the package. For example "All CD Baby Stores", "CD Baby Pro", and "CD Baby Standard" are all acceptable values. If you are not sure, check with the digital distributor (CD Baby, TuneCore, Symphonic) or the client.
About this article
This is one of several articles that supplement the reference. If you came here from one of our main articles, you might want to go back and continue where you left off. If you've finished all the main articles, you might want to continue browsing these reference articles:
