Skip to main content

List stories

GET 
/stories

Retrieves a list of available stories. Supports the following advanced filtering and sorting options for the associated quiz data: Filtering Options:

  • filter=quiz=true: Lists all Story objects that have an active quiz feature.
  • filter=quiz.isMandatory=true: Lists all Story objects where the quiz is mandatory for the user.
  • filter=quiz.isOpenToTake=true: Lists all Story objects where the quiz is currently open for the user to take an attempt.
  • filter=quiz.isSuccess=true: Lists all Story objects with a successfully finished attempt and where showing the result is enabled.
  • filter=quiz.isFailure=true: Lists all Story objects with a failed attempt and where showing the result is enabled.

Sorting Options:

  • sort=quiz.dueUntilUtc:desc: Sorts the list by the quiz expiry date in descending order.
  • sort=quiz.report.rate:desc: Sorts the list by the latest attempt rate in descending order.
  • sort=quiz.latestAttemptUtc:desc: Sorts the list by the latest attempt time in descending order.

Note: Omitting :desc in the sorting parameter reverses the order to ascending. For example, sort=quiz.dueUntilUtc will sort by the expiry date in ascending order. Leveraging these filters and sorting parameters enables efficient querying of Story objects tailored to specific conditions and priorities.

Request​

Responses​

Successful response.

Response Headers
    X-Total-Count

    Total count of items