Links

Get available catalog items

post
https://ris.rightsline.com
/v4/avails/available-catalog-items
Get available catalog items
Example API call body:
{
"dim1": [6],
"dim2": [43],
"dim3": [29],
"dim4": [],
"windowStart": "2021-10-01",
"windowEnd": "2021-10-31",
"isExclusive": false,
"matchType": "CoverEntire",
"isExact": false,
"start": 0,
"rows": 25,
"templateIds": [1,2],
"statusIds": [1],
"characteristics":{
"genre":["Adventure"]
},
"rightTemplateIds":[2,4]
}
The characteristics field allows you to filter the catalog items in the response that contain a specific value or group of values for a given characteristic. In the example request above, only catalog items that have a genre value of Adventure will be returned in the response.
Response
On a successful API call (HTTP Status 200) the following information will be returned:
Parameter
Type
Description
rowCount
number
number of rows returned
rows
array of availability objects (see table below)
availability data
Availability Object
Parameter
Type
Description
LastUpdatedDate
string
Last updated date / time
Template
template data (see table below)
Template data structure
Status
status data (see table below)
Status data structure
WindowStart
YYYY-MM-DD
Start window date
WindowEnd
YYYY-MM-DD
End window date
Dim1
array of char data (see table below)
Dimension 1 data
Dim2
array of char data (see table below)
Dimension 2 data
Dim3
array of char data (see table below)
Dimension 3 data
Dim4
array of char data (see table below)
Dimension 4 data
IsExclusive
bool
Flag for exclusivity
IsExact
bool
Flag for exact match
Available
string
Available status
ReasonUnavailable
string
Reason, if unavailable
Template Data
Parameter
Type
Description
templateId
number
Template identifier
templateName
string
Template name
processId
number
Process identifier
processName
string
Process name
Status Data
Parameter
Type
Description
statusId
number
Status identifier
statusName
string
Status name
Dimension Data
Parameter
Type
Description
id
number
Identifier
value
string
Dimension Value
xref
string
Dimension Cross Reference Value
Example API response:
{
"rowCount": 1,
"rows": [
{
"lastUpdatedDate": "2021-10-05T22:41:58.467Z",
"template": {
"templateId": 19,
"templateName": "Movie",
"processId": 0,
"processName": null
},
"status": {
"statusId": 11,
"statusName": "Approved"
},
"windowStart": "2021-10-01",
"windowEnd": "2021-10-31",
"dim1": [
{
"id": 6,
"value": "SVOD - Sublicense",
"xref": "SVOD"
}
],
"dim2": [
{
"id": 43,
"value": "North America",
"xref": null
}
],
"dim3": [
{
"id": 29,
"value": "English",
"xref": "en"
}
],
"dim4": null,
"isExclusive": false,
"isExact": false,
"matchType": "CoverEntire",
"available": "Partially",
"reasonUnavailable": "Limited (Term)",
"id": 36816,
"title": "title"
}
]
}