Skip to content

Statistics

The statistics resource returns aggregate counts and metadata about the Paperless-ngx document archive. It is a parameter-free singleton call.

Model

See pypaperless/models/statistics.py for all fields and pypaperless/models/types.py for enum and filter types, and the Paperless-ngx API docs for the upstream schema.

Fetch

No primary key - call without arguments:

stats = await paperless.statistics()

print(stats.documents_total)      # 1024
print(stats.documents_inbox)      # 3
print(stats.current_asn)          # 512
print(stats.correspondent_count)  # 47

for ft in stats.document_file_type_counts or []:
    print(ft.mime_type, ft.mime_type_count)
    # "application/pdf" 980
    # "image/jpeg" 44