1. Analytics
Flow Download Manager API
  • Public
    • Health check
      GET
    • List published books
      GET
    • Request a single book download
      POST
    • Request a bulk download (all books for a language)
      POST
    • Download a file via token
      GET
  • Books
    • List all books
      GET
    • Create a book
      POST
    • Get book details
      GET
    • Update a book
      PUT
    • Soft-delete a book
      DELETE
    • Bulk upsert books
      POST
    • Reorder books
      PATCH
  • Files
    • List files for a book
      GET
    • Add a file (local upload or cloud link)
      POST
    • Upload or replace a file
      PUT
    • Update file metadata
      PATCH
    • Delete a file
      DELETE
  • Translations
    • Add or update a translation
      POST
    • Delete a translation
      DELETE
  • Languages
    • List all languages
    • Create a language
    • Get language usage stats
    • Update a language
    • Delete a language
  • Channels
    • List distribution channels
    • Create a channel
    • Update a channel
    • Delete a channel
    • Get publication matrix
    • Toggle a publication
  • Contacts
    • List contacts (paginated)
    • Get contact details with download history
    • Export contacts as CSV
  • Analytics
    • Dashboard summary
      GET
    • Downloads over time
      GET
    • Downloads by book
      GET
    • Downloads by country
      GET
    • Downloads by language
      GET
    • Downloads by device type
      GET
    • Download event log (paginated)
      GET
    • Export download events as CSV
      GET
  • Settings
    • Get app settings
    • Update GeoIP database
  • API Keys
    • List API keys
    • Create an API key
    • Revoke an API key
  • Schemas
    • Error
    • Pagination
    • PublicBook
    • AdminBook
    • BookDetail
    • BookFile
    • Translation
    • Language
    • Channel
    • ApiKey
    • Contact
    • DownloadEvent
  1. Analytics

Download event log (paginated)

GET
/api/admin/analytics/downloads

Request

Authorization
API Key
Add parameter in cookie
next-auth.session-token
Example:
next-auth.session-token: ********************
or
Query Params

Responses

🟢200
application/json
Paginated download events
Body

🟠401Unauthorized
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/api/admin/analytics/downloads?startDate&endDate&languageId&bookId&page&limit'
Response Response Example
200 - Success
{
    "downloads": [
        {
            "id": "ev1a2b3c-d4e5-6789-abcd-ef1234567890",
            "downloadedAt": "2026-03-27T08:15:00.000Z",
            "isDownloadAll": 0,
            "booksCount": 1,
            "ipAddress": "203.0.113.42",
            "countryCode": "US",
            "countryName": "United States",
            "city": "New York",
            "deviceType": "desktop",
            "browserName": "Chrome",
            "browserVersion": "122.0",
            "osName": "Windows",
            "osVersion": "11",
            "referrer": "https://google.com",
            "utmSource": "google",
            "utmMedium": "organic",
            "utmCampaign": null,
            "bookTitle": "The Great Controversy",
            "fileType": "pdf",
            "fileName": "gc-en.pdf",
            "languageName": "English",
            "languageCode": "en",
            "contactEmail": "john@example.com",
            "contactFirstName": "John",
            "contactLastName": "Doe"
        }
    ],
    "pagination": {
        "page": 1,
        "limit": 50,
        "total": 6200,
        "totalPages": 124
    }
}
Modified at 2026-03-27 22:49:45
Previous
Downloads by device type
Next
Export download events as CSV
Built with