Get All Watchlists Belonging to a User

Was this article helpful?

This endpoint retrieves all of the watchlists that belong to the specified user (identified in the account_token parameter).

HTTP Request


Query Parameters

Parameter Description Type Required
api_version Must be v3. String Yes (URL)
account_token Used by the Watchlist Service to reference the watchlist associated with a particular end user (identified by their UUID). For details, see Ooyala Account Token API. String Yes (URL body)

Return Codes

Code Reason Description
200 OK GET request succeeded.
400 Request error Failed due to missing or badly formatted parameters.
401 Unauthorized The specified account_token is invalid.
404 Not found The server is down.
500 Internal server error An internal server error occurred.


Response (Success)

This assumes that the user created N watchlists previously. A default watchlist is created automatically for every user.

    "account_pcode": "t5SYJyOnyQw1eBBfirDLeVPt_p18",
    "account_id": "18285cswfcdf204896230fc2a67a5faf",
    "watchlist_id": "d074ef35-253d-4f6a-82a1-1be382g7c180",
    "created_at": 1447185083488,
    "name": "default",
    "updated_at": 1454363150293,
    "number_of_items": 0
    "account_pcode": "t5SYJyOnyQw1eBBfirDLeVPt_p18",
    "account_id": "18285cswfcdf204896230fc2a67a5faf",
    "watchlist_id": "d074b535-253d-4f6a-82a1-1be382g7c181",
    "created_at": 1454353570368,
    "name": "action movies",
    "updated_at": 1454353570368,
    "number_of_items": 0
    "account_pcode": "t5SYJyOnyQw1eBBfirDLeVPt_p18",
    "account_id": "18285cswfcdf204896230fc2a67a5faf",
    "watchlist_id": "d074b535-253d-4f6a-82a1-1be384e7c182",
    "created_at": 1454351584074,
    "name": "horror movies",
    "updated_at": 1454351584274,
    "number_of_items": 2