The /my/notifications API expects a show_maximum query parameter to determine how many notifications should be returned. However, it currently doesn’t behave as intended. The issue is in this line, rather than using total, the code should reference params[:show_maximum].

Additionally, the API should be updated to support the filter options already defined in the controller, such as state and kind. The documentation also lists a notifications_type parameter, which is no longer supported in the code and should be removed from the docs.