Skip to main content

COUNTER 5.1 Reporting

Standards-compliant usage statistics for librarians and consortia

R2 Digital Library is fully compliant with the Release 5.1 COUNTER Code of Practice. All usage reports are available in TSV and JSON formats via the admin dashboard and programmatically via the SUSHI REST API.

Available Reports

TR
Title Report

Usage at the book/title level — the standard report for monograph collections.

TR_B1
Title Report – Book

Requests and unique item requests for books, with section filters.

DR
Database Report

Aggregated database-level usage across your entire R2 subscription.

PR
Platform Report

Platform-wide searches, requests, and investigations.

IR
Item Report

Chapter-level granularity for content-level analysis.

Legacy COUNTER Release 4 (BR1, BR2, JR1, JR2)

For institutions still auditing against the R4 baseline, R2 also emits the four legacy reports in TSV format. Underlying events are the same as R5; the reports just apply the R4 shape + metric mapping.

BR1
Book Report 1 (R4)

Successful Title Requests by Month and Title. Legacy R4 format.

BR2
Book Report 2 (R4)

Successful Section Requests by Month and Title. Legacy R4 format.

JR1
Journal Report 1 (R4)

Successful Full-Text Article Requests by Month and Journal.

JR2
Journal Report 2 (R4)

Access Denied by Journal and Category (licensing + concurrent-limit turnaways).

GET /api/counter/reports/r4/{br1|br2|jr1|jr2}?begin_date=2026-01-01&end_date=2026-12-31&api_key=…
Returns TSV. The leading 7-row header block matches the R4 NISO SUSHI-Lite delivery format.

SUSHI API

# Fetch Title Report for 2026
curl -H "Authorization: Bearer {your_api_key}" \
  "https://api.r2library.example/sushi/r51/reports/tr?\
  customer_id={id}&begin_date=2026-01&end_date=2026-12"