Skip to content

Queries

get_latest_records

def get_latest_records(
    queryset: QuerySet,
    date_field: str,
    fields: list = list(),
    field_map: dict = dict(),
    limit: int = 5,
): ...

Fetches the most recent rows from a queryset, ordered by a date field, as plain dicts — handy for "recent activity" style lists without pulling full model instances.

Parameter Type Default Description
queryset QuerySet — Source queryset
date_field str — Field to order by (descending) and to expose as date
fields list [] Extra field names to include, passed positionally to .values()
field_map dict {} Extra annotation_name: expression pairs, passed as kwargs to .values()
limit int 5 Maximum number of records returned 
get_latest_records(
    Order.objects.filter(customer=customer),
    date_field="placed_at",
    fields=["id", "total"],
    limit=10,
)
# [{"id": 1, "total": Decimal("42.00"), "date": datetime(...)}, ...]

Every returned dict includes a date key mapped from date_field (via F(date_field)), regardless of what fields/field_map request.