AnyChallenger API Documentation

Complete API reference for the AnyChallenger sports challenge platform built with Kotlin and Ktor. Build applications to create, manage, and discover sports challenges across Egypt.

Support My Work

If you find this API documentation helpful and would like to support my development work, consider sending a small contribution to my digital wallet. Every bit helps me continue creating quality software and maintaining these resources.

💳Digital Wallet Support

Send your support amount directly to my digital wallet. Your contribution helps me maintain and improve these APIs and create more useful tools for the developer community.

Wallet Number:
+20 109 958 0723

Available on Vodafone Cash, Orange Money, Etisalat, and other digital wallet services

🌟What Your Support Enables

  • Maintain and improve API documentation
  • Create new features and endpoints
  • Provide better developer support
  • Develop more open-source projects
  • Keep APIs free and accessible

Thank you for your support! 🙏 Every contribution, no matter how small, makes a difference.

👨‍💻 Developer Information

Ahmed Abdelraheem Halawy

Passionate and dedicated Android Developer with 3 years of experience in creating high-performance mobile applications. Proficient in Java, Kotlin, and Android SDK, with a strong grasp of modern mobile design principles and best practices. Focused on delivering intuitive, user-friendly solutions through teamwork and innovative problem-solving.

📍 Location:Egypt
📱 Phone:+20 109 158 0723
💬 WhatsApp:+20 109 958 0723
💼 Experience:3+ Years Android Development

🛠️ Technical Skills

Android Development
JavaKotlinJetpack ComposeXML
Architecture & Patterns
MVVMMVCMVPClean Architecture
Libraries & Tools
RetrofitDagger HiltFirebaseRoom DB
Other Technologies
KtorGitSOLID Principles

🚀 Project Portfolio

Any Challenger App
Jul 2025 - Aug 2025

🔗 API Implementation

This project implements the API documented on this page. The backend API provides all the functionality for user authentication, challenge management, and location services.

Developed a mobile application that allows sports teams to easily book fields, organize schedules, and compete in friendly matches. Implemented features for real-time booking management, team creation, and match invitations, ensuring a seamless user experience for both players and organizers.

RetrofitREST APIDagger HiltClean ArchitectureMVVMJetpack ComposeKtorJWT
Questions And Answer App
Mar 2025 - Apr 2025

Developed a feature-rich quiz application with a sleek and responsive UI, supporting dynamic question categories, instant feedback, offline mode, and AdMob integration for monetization. Enhanced user engagement through interactive design and smooth navigation.

KotlinJetpack ComposeRoomDBFlowMVVMAdMob
Masar App
Jun 2023 - Aug 2023

I developed Masar, a new and unique mobile application designed to provide safe, fast, and convenient transportation. With Masar, users can easily book vehicles that fit their needs and choose schedules that match their lifestyle. The app ensures peace of mind, knowing their loved ones are in safe hands.

KotlinXMLMVVMFirebaseGoogle Map
WassalKom App
Jan 2023 - Jun 2023

Built Wassalkom, the first delivery application in Upper Egypt, enabling users to order food, medicine, groceries, and more from local stores. Implemented a seamless ordering process with product selection, cart management, payment integration, and order confirmation.

KotlinXMLMVVMFirebaseGoogle Map
Story Every Day App
Nov 2022 - Dec 2022

Developed an application that presents stories and tales for all ages. It includes many and varied sections, offers multiple advantages, and is updated regularly. Download the application now and enjoy the experience.

KotlinXMLMVVMFirebaseMotion Layout
Personal Website
Portfolio

Personal portfolio and Q&A platform showcasing projects and expertise with interactive features and professional presentation.

PortfolioWeb

📍 Location Services

Get comprehensive governorates and cities data for location-based filtering across all Egyptian regions.

GET/governorates
GET/cities/{governorateId}

🔐 Authentication

Manage user accounts, authentication, and password recovery with secure JWT token-based authentication.

POST/register
POST/login
POST/sendOTP
POST/verify_code
POST/reset_password
POST/log_out
GET/information_user/{user_id}

🔑 Token Management

Manage JWT access tokens and refresh tokens for secure authentication and session management.

POST/generate_access_token
POST/verify_access_token

⚽ Challenge Management

Create, read, update, and delete sports challenges with full CRUD operations and advanced filtering capabilities.

POST/new_challenge
GET/challenges/{page}
GET/challenge/{postId}
PUT/update_challenge/{postId}
DELETE/delete_challenge/{postID}
POST/filter_challenges/{page}
GET/challenges_user/{user_id}/{page}

🔒 Authentication Guide

Most endpoints require authentication using JWT Bearer tokens. Include the token in the Authorization header:

Authorization Header Format:
Authorization: Bearer YOUR_ACCESS_TOKEN

Important: Access tokens expire after a certain period. Use the refresh token to generate new access tokens when needed.

⚠️ Error Handling

All endpoints return consistent error responses with bilingual Arabic and English messages:

Error Response Format:
{
              "messageAr": "رسالة الخطأ بالعربية",
              "messageEn": "Error message in English",
              "isSuccessful": false,
              "statusCode": 400
            }

Base URL: https://anychallenger-fbda9ed74e45.herokuapp.com

Built with Kotlin, Ktor, and MongoDB • All timestamps are in ISO 8601 format (UTC)