New endpoint to return a summary of returned letters for the service.

app/dao/returned_letters_dao.py

@@ -1,5 +1,6 @@
 from datetime import datetime
 
+from sqlalchemy import func, desc
 from sqlalchemy.dialects.postgresql import insert
 
 from app import db
@@ -7,6 +8,19 @@ from app.dao.dao_utils import transactional
 from app.models import Notification, NotificationHistory, ReturnedLetter
 
 
+
+def _get_notification_ids_for_references(references):
+    notification_ids = db.session.query(Notification.id, Notification.service_id).filter(
+        Notification.reference.in_(references)
+    ).all()
+
+    notification_history_ids = db.session.query(NotificationHistory.id, NotificationHistory.service_id).filter(
+        NotificationHistory.reference.in_(references)
+    ).all()
+
+    return notification_ids + notification_history_ids
+
+
 @transactional
 def insert_or_update_returned_letters(references):
     data = _get_notification_ids_for_references(references)
@@ -28,13 +42,14 @@ def insert_or_update_returned_letters(references):
         db.session.connection().execute(stmt)
 
 
-def _get_notification_ids_for_references(references):
-    notification_ids = db.session.query(Notification.id, Notification.service_id).filter(
-        Notification.reference.in_(references)
+def get_returned_letter_summary(service_id):
+    return db.session.query(
+        func.count(ReturnedLetter.notification_id).label('returned_letter_count'),
+        ReturnedLetter.reported_at
+    ).filter(
+        ReturnedLetter.service_id == service_id,
+    ).group_by(
+        ReturnedLetter.reported_at
+    ).order_by(
+        desc(ReturnedLetter.reported_at)
     ).all()
-
-    notification_history_ids = db.session.query(NotificationHistory.id, NotificationHistory.service_id).filter(
-        NotificationHistory.reference.in_(references)
-    ).all()
-
-    return notification_ids + notification_history_ids

app/service/rest.py

@@ -29,6 +29,7 @@ from app.dao.fact_notification_status_dao import (
 )
 from app.dao.inbound_numbers_dao import dao_allocate_number_for_service
 from app.dao.organisation_dao import dao_get_organisation_by_service_id
+from app.dao.returned_letters_dao import get_returned_letter_summary
 from app.dao.service_data_retention_dao import (
     fetch_service_data_retention,
     fetch_service_data_retention_by_id,
@@ -939,3 +940,12 @@ def check_if_reply_to_address_already_in_use(service_id, email_address):
         raise InvalidRequest(
             "Your service already uses ‘{}’ as an email reply-to address.".format(email_address), status_code=400
         )
+
+
+@service_blueprint.route('/returned-letter-summary')
+def returned_letter_summary(service_id):
+    results = get_returned_letter_summary(service_id)
+
+    json_results = [{'returned_letter_count': x.returned_letter_count, 'reported_at': x.reported_at} for x in results]
+
+    return jsonify(json_results)