Request a single book download

POST

/api/download/submit

Creates or updates a contact record, logs the download event with GeoIP
and device data, increments the file download counter, and returns a
time-limited download URL.

Request

Query Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Download URL generated

Body

🟠400

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/download/submit?utm_source&utm_medium&utm_campaign' \
--header 'Content-Type: application/json' \
--data-raw '{
    "bookSlug": "the-great-controversy",
    "languageCode": "en",
    "fileType": "pdf",
    "contact": {
        "firstName": "John",
        "email": "john@example.com",
        "country": "US"
    }
}'

Response Example

200 - Success

{
    "downloadUrl": "/api/download/eyJhbGciOiJIUzI1NiJ9..."
}

Modified at 2026-03-27 22:49:45

List published books

Request a bulk download (all books for a language)