Waavn API – User Endpoint Documentation

This is the official guide for using api.waavn.com to automate APK customization using your API key.

1. Register

POST https://api.waavn.com/register

Create a new user account.

curl -X POST https://api.waavn.com/register -H "Content-Type: application/json" -d '{"email":"[email protected]", "password":"YourPassword123"}'

2. Login

POST https://api.waavn.com/login

curl -X POST https://api.waavn.com/login -H "Content-Type: application/json" -d '{"email":"[email protected]", "password":"YourPassword123"}'

3. Chunked APK Upload

POST https://api.waavn.com/upload-chunk

Upload a large APK file in 2MB chunks.

Required headers: X-API-Key

Required fields: chunk (file), upload_id, chunk_index, total_chunks

curl -X POST https://api.waavn.com/upload-chunk \
  -H "X-API-Key: your_api_key" \
  -F "chunk=@chunk_0.part" \
  -F "upload_id=unique-123" \
  -F "chunk_index=0" \
  -F "total_chunks=25"

4. Validate APK Template

POST https://api.waavn.com/generate-template

Validate the app name from a previously uploaded APK using chunks.

Required headers: X-API-Key

Required form: apk_file_path and app_name

curl -X POST https://api.waavn.com/generate-template \
  -H "X-API-Key: your_api_key" \
  -F "apk_file_path=unique-123.apk" \
  -F "app_name=Royal TV Pro"

5. Finalize Template

POST https://api.waavn.com/finalize-template

Finish and save your generated template for APK builds.

JSON body: token, build_name, validated_app_name, image_groups, smali_replacements

6. Submit APK Build

POST https://api.waavn.com/submit-build

Send a completed JSON template and assets to build the APK.

7. Check Build Status

GET https://api.waavn.com/task-status/{task_id}

Check whether your build succeeded or failed.

8. My Builds

GET https://api.waavn.com/my-builds

Returns a list of builds linked to your API key.