Skip to content

code-with-charles/subscription-tracker-api

Repository files navigation

Subscription Tracker API

A lightweight, efficient, and secure RESTful API designed to help users track and manage their subscriptions in one place. The Subscription Tracker API enables developers to integrate subscription management features into their apps, dashboards, or automation tools. Screenshot 2025-11-12 160703 Screenshot 2025-11-12 162416 Screenshot 2025-11-11 145329 - Copy Screenshot 2025-11-11 131330

📌 Overview

This API allows users to:

  • Add and manage subscriptions
  • Track renewal dates
  • Get alerts for upcoming renewals
  • Calculate total monthly and yearly costs
  • Categorize subscriptions by type (Entertainment, Utilities, SaaS, etc.)
  • Manage user accounts securely

🚀 Features

  • CRUD operations for subscriptions
  • User authentication (JWT-based)
  • Cost analysis (monthly & annual)
  • Renewal reminders support
  • Category-based filtering
  • RESTful endpoints for easy integration
  • MongoDB Atlas database support
  • Error handling & validation built-in

🏗️ Tech Stack

  • Backend: Node.js / Express
  • Database: MongoDB / MongoDB Atlas
  • Auth: JWT, bcrypt
  • Tools: Postman / Supertest for testing

🔌 API Endpoints

Auth

Method Endpoint Description
POST /api/auth/register Register a new user
POST /api/auth/login Log in user & get token

Subscriptions

Method Endpoint Description
GET /api/subscriptions Get all subscriptions for user
POST /api/subscriptions Add new subscription
GET /api/subscriptions/:id Get subscription by ID
PUT /api/subscriptions/:id Update subscription
DELETE /api/subscriptions/:id Delete subscription

⚙️ Installation

  1. Clone the repo:
git clone https://github.com/your-username/subscription-tracker-api.git
  1. Install dependencies:
npm install
  1. Add your environment variables in .env:
MONGO_URI=your-mongodb-atlas-uri
JWT_SECRET=your-secret
PORT=5000
  1. Start server:
npm run dev

🧪 Testing

To run automated tests:

npm test

##charlesmarxist2@gmail.com

Clean. Simple. Reliable. Your all-in-one subscription management API.

About

A lightweight, efficient, and secure RESTful API designed to help users track and manage their subscriptions in one place. The Subscription Tracker API enables developers to integrate subscription management features into their apps, dashboards, or automation tools.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors