Grails API Documentation

GET /api/v1/watchlist/lists

Get all of the authenticated user’s watchlists with item counts. The default list is returned first.

Authentication: Required

Cache: None

Sample Request


curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://api.grails.app/api/v1/watchlist/lists

Response


// 200 OK
{
  "success": true,
  "data": {
    "lists": [
      {
        "id": 1,
        "name": "Watchlist",
        "isDefault": true,
        "itemCount": 15,
        "createdAt": "2026-01-15T00:00:00.000Z",
        "updatedAt": "2026-04-07T12:00:00.000Z"
      },
      {
        "id": 2,
        "name": "Favorites",
        "isDefault": false,
        "itemCount": 5,
        "createdAt": "2026-03-01T00:00:00.000Z",
        "updatedAt": "2026-04-05T00:00:00.000Z"
      }
    ]
  },
  "meta": {
    "timestamp": "2026-04-08T00:00:00.000Z",
    "version": "1.0.0"
  }
}