diff --git a/src/lib/types/mal/index.ts b/src/lib/types/mal/index.ts
new file mode 100644
index 0000000..3279d57
--- /dev/null
+++ b/src/lib/types/mal/index.ts
@@ -0,0 +1,87 @@
+/*
+
+query Parameters
+status
+string
+
+Filters returned anime list by these statuses.
+
+To return all anime, don't specify this field.
+
+Valid values:
+
+    watching
+    completed
+    on_hold
+    dropped
+    plan_to_watch
+
+sort
+string
+
+Valid values:
+Value 	Order
+list_score 	Descending
+list_updated_at 	Descending
+anime_title 	Ascending
+anime_start_date 	Descending
+anime_id (Under Development) 	Ascending
+limit
+integer
+Default: 100
+
+The maximum value is 1000.
+offset
+integer
+Default: 0
+
+*/
+
+/*
+sample response
+
+{
+	"data": [
+		{
+			"node": {
+				"id": 31646,
+				"title": "3-gatsu no Lion",
+				"main_picture": {
+					"medium": "https://cdn.myanimelist.net/images/anime/3/82899.jpg",
+					"large": "https://cdn.myanimelist.net/images/anime/3/82899l.jpg"
+				}
+			},
+			"list_status": {
+				"status": "watching",
+				"score": 0,
+				"num_episodes_watched": 2,
+				"is_rewatching": false,
+				"updated_at": "2025-07-17T00:57:26+00:00",
+				"start_date": "2025-07-16"
+			}
+		},
+		{
+			"node": {
+				"id": 38101,
+				"title": "5-toubun no Hanayome",
+				"main_picture": {
+					"medium": "https://cdn.myanimelist.net/images/anime/1819/97947.jpg",
+					"large": "https://cdn.myanimelist.net/images/anime/1819/97947l.jpg"
+				}
+			},
+			"list_status": {
+				"status": "completed",
+				"score": 0,
+				"num_episodes_watched": 12,
+				"is_rewatching": false,
+				"updated_at": "2019-06-02T09:12:42+00:00",
+				"start_date": "2019-05-31",
+				"finish_date": "2019-06-02"
+			}
+		}
+	],
+	"paging": {
+		"next": "https://api.myanimelist.net/v2/users/CaZzzer/animelist?offset=2&fields=list_status&limit=2"
+	}
+}
+*/