1. Contacts
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
      GET
    • Create a language
      POST
    • Get language usage stats
      GET
    • Update a language
      PUT
    • Delete a language
      DELETE
  • Channels
    • List distribution channels
    • Create a channel
    • Update a channel
    • Delete a channel
    • Get publication matrix
    • Toggle a publication
  • Contacts
    • List contacts (paginated)
      GET
    • Get contact details with download history
      GET
    • Export contacts as CSV
      GET
  • Analytics
    • Dashboard summary
    • Downloads over time
    • Downloads by book
    • Downloads by country
    • Downloads by language
    • Downloads by device type
    • Download event log (paginated)
    • Export download events as CSV
  • 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. Contacts

List contacts (paginated)

GET
/api/admin/contacts

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 contacts
Body

🟠401Unauthorized
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/api/admin/contacts?search&country&city&languageId&startDate&endDate&page&limit'
Response Response Example
200 - Success
{
    "contacts": [
        {
            "id": "co1a2b3c-d4e5-6789-abcd-ef1234567890",
            "email": "john@example.com",
            "firstName": "John",
            "lastName": "Doe",
            "phone": "+1234567890",
            "country": "US",
            "firstDownloadAt": "2026-02-15T10:30:00.000Z",
            "lastDownloadAt": "2026-03-20T08:15:00.000Z",
            "totalDownloads": 5
        }
    ],
    "pagination": {
        "page": 1,
        "limit": 50,
        "total": 128,
        "totalPages": 3
    }
}
Modified at 2026-03-27 22:49:45
Previous
Toggle a publication
Next
Get contact details with download history
Built with