Get Smart Lists¶

GET /rest/asset/v1/smartLists.json

Permissions Read-Asset or Read-Write Asset

Method: GET
Path: /rest/asset/v1/smartLists.json
Tag: Smart Lists
Operation ID: getSmartListsUsingGET

Retrieves a list of user created Smart List records. Required Permissions: Read-Asset or Read-Write Asset

Formats¶

Request: application/x-www-form-urlencoded
Response: application/json

Request¶

Query parameters¶

Name	Type	Required	Description
`folder`	string	No	JSON representation of parent folder, with members 'id', and 'type' which may be 'Folder' or 'Program'
`offset`	integer (int32)	No	Integer offset for paging
`maxReturn`	integer (int32)	No	Maximum number of smart lists to return. Max 200, default 20.
`earliestUpdatedAt`	string	No	Exclude smart lists prior to this date. Must be valid ISO-8601 string. See Datetime field type description.
`latestUpdatedAt`	string	No	Exclude smart lists after this date. Must be valid ISO-8601 string. See Datetime field type description.

Example request¶

GET {{base_url}}/rest/asset/v1/smartLists.json?folder={{folder}}&offset={{offset}}&maxReturn={{maxReturn}}&earliestUpdatedAt={{earliestUpdatedAt}}&latestUpdatedAt={{latestUpdatedAt}}
Accept: application/json

Responses¶

200 — OK¶

Schema: model: ResponseOfSmartListResponse

Generated example¶

{
  "errors": [
    {
      "code": "string",
      "message": "string"
    }
  ],
  "requestId": "123",
  "result": [
    {
      "id": 123,
      "name": "Example name",
      "description": "string",
      "createdAt": "2026-01-15T10:30:00Z",
      "updatedAt": "2026-01-15T10:30:00Z",
      "url": "https://example.com",
      "folder": {
        "id": 123,
        "type": "Folder"
      },
      "workspace": "string"
    }
  ],
  "success": true,
  "warnings": [
    "string"
  ]
}

Referenced models¶

ResponseOfSmartListResponse

Source¶

Generated from swagger-asset.json.

Generated examples are inferred from the schema. They are illustrative and may not be valid production payloads.