# Listings List

API call format

GET /broker/listings

Description

This call gets all listings which start time > <start_timestamp>.

Precondition

  • No authorization token is needed.
  • Mandatory elements (should be specified):
    • <start_timestamp> - valid Unix timestamp.

Postcondition

  • On success response code should be 200
  • On success all listings which satisfies the timestamp filter are returned.
  • On failure an error will be returned with the right error code and description.

Example:

[Request] GET https://<base_api_url>/broker/listings
{
    "start": <start_timestamp>
}
[Request Headers] {"Content-Type":"application/json","Accept":"application/json","Authorization":"<IdToken>"}
[Response] 200
[Response Headers] {"Content-Type":["application/json"],"Content-Length":["..."],"Connection":["keep-alive"],"Date":["..... GMT"],"x-amzn-RequestId":["....."],....]}
[Response] 
{
  "status": true,
  "data": [
    {
		"channel": "<channel_guid_01>",
		"start": <start_timestamp>,
		"title": "<channel_title>",
		"description": "<channel_description>",
		"color": "#2ECC70",
		"end": <end_timestamp>
    },
    {
 		"channel": "<channel_guid_02>",
		"start": <start_timestamp>,
		"title": "<channel_title>",
		"description": "<channel_description>",
		"color": "#2ECC70",
		"end": <end_timestamp>
    },
    .........
    {
		"channel": "<channel_guid_>",
		"start": <start_timestamp>,
		"title": "<channel_title>",
		"description": "<channel_description>",
		"color": "#2ECC70",
		"end": <end_timestamp>
    }
  ]
}