@yaelouuu/fortnite-api 5.0.0 → 6.0.0

package/dist/client.d.ts

@@ -49,9 +49,9 @@ export declare class FortniteAPI {
     /**
      * Internal method to make HTTP requests
      */
-    request<T>(endpoint: string, options?: RequestInit, version?: "v1" | "v2" | "v3"): Promise<T>;
+    request<T>(endpoint: string, options?: RequestInit, version?: "v1" | "v2"): Promise<T>;
     /**
      * Internal method for multipart/form-data requests (file uploads)
      */
-    requestMultipart<T>(endpoint: string, formData: FormData, version?: "v1" | "v2" | "v3"): Promise<T>;
+    requestMultipart<T>(endpoint: string, formData: FormData, version?: "v1" | "v2"): Promise<T>;
 }

package/dist/resources/battlepass.js

@@ -9,7 +9,7 @@ class BattlePassResource {
      * Get current battle pass items
      */
     async getBattlePass() {
-        return this.client.request("/battlepass");
+        return this.client.request("/shop/battlepass");
     }
 }
 exports.BattlePassResource = BattlePassResource;

package/dist/resources/cosmetics.js

@@ -22,6 +22,10 @@ class CosmeticsResource {
             queryParams.set("set", params.set);
         if (params?.search)
             queryParams.set("search", params.search);
+        if (params?.season)
+            queryParams.set("season", params.season.toString());
+        if (params?.chapter)
+            queryParams.set("chapter", params.chapter.toString());
         const query = queryParams.toString();
         const endpoint = query ? `/cosmetics/all?${query}` : "/cosmetics/all";
         return this.client.request(endpoint);

package/dist/resources/map.d.ts

@@ -5,14 +5,21 @@ export declare class MapResource {
     constructor(client: FortniteAPI);
     /**
      * Get current Fortnite map with POIs
+     * @param version - Optional specific map version to retrieve
      */
-    getCurrent(): Promise<MapResponse>;
+    getCurrent(version?: string): Promise<MapResponse>;
     /**
      * Get current map image URL
+     * @param version - Optional specific map version to retrieve
      */
-    getImage(): Promise<MapImageResponse>;
+    getImage(version?: string): Promise<MapImageResponse>;
     /**
      * Get historical map data
+     * @param options.chapter - Filter by chapter number
+     * @param options.season - Filter by season number
      */
-    getHistory(): Promise<MapHistoryResponse>;
+    getHistory(options?: {
+        chapter?: number;
+        season?: number;
+    }): Promise<MapHistoryResponse>;
 }

package/dist/resources/map.js

@@ -7,21 +7,33 @@ class MapResource {
     }
     /**
      * Get current Fortnite map with POIs
+     * @param version - Optional specific map version to retrieve
      */
-    async getCurrent() {
-        return this.client.request("/map");
+    async getCurrent(version) {
+        const query = version ? `?version=${encodeURIComponent(version)}` : "";
+        return this.client.request(`/map${query}`);
     }
     /**
      * Get current map image URL
+     * @param version - Optional specific map version to retrieve
      */
-    async getImage() {
-        return this.client.request("/map/image");
+    async getImage(version) {
+        const query = version ? `?version=${encodeURIComponent(version)}` : "";
+        return this.client.request(`/map/image${query}`);
     }
     /**
      * Get historical map data
+     * @param options.chapter - Filter by chapter number
+     * @param options.season - Filter by season number
      */
-    async getHistory() {
-        return this.client.request("/map/history");
+    async getHistory(options) {
+        const params = new URLSearchParams();
+        if (options?.chapter)
+            params.set("chapter", options.chapter.toString());
+        if (options?.season)
+            params.set("season", options.season.toString());
+        const query = params.toString() ? `?${params.toString()}` : "";
+        return this.client.request(`/map/history${query}`);
     }
 }
 exports.MapResource = MapResource;

package/dist/resources/quests.d.ts

@@ -29,7 +29,7 @@ export declare class QuestsResource {
      *
      * **Authentication**: Requires user's personal Fortnite OAuth token
      *
-     * **API Version**: v3
+     * **API Version**: v2
      *
      * **Rate Limit**: Standard API rate limits apply
      *

package/dist/resources/quests.js

@@ -31,7 +31,7 @@ class QuestsResource {
      *
      * **Authentication**: Requires user's personal Fortnite OAuth token
      *
-     * **API Version**: v3
+     * **API Version**: v2
      *
      * **Rate Limit**: Standard API rate limits apply
      *
@@ -56,7 +56,7 @@ class QuestsResource {
             headers: {
                 "x-fortnite-token": fortniteToken,
             },
-        }, "v3");
+        }, "v2");
     }
 }
 exports.QuestsResource = QuestsResource;

package/dist/resources/tournaments.d.ts

@@ -4,17 +4,15 @@ export declare class TournamentsResource {
     private client;
     constructor(client: FortniteAPI);
     /**
-     * Get current events
-     * No parameters needed - uses API's default account
+     * Get currently active and upcoming tournaments, enriched with CMS metadata
      */
     getCurrent(): Promise<any>;
     /**
-     * Get past events
-     * No parameters needed - uses API's default account
+     * Get all tournaments including past ones, enriched with CMS metadata
      */
     getPast(): Promise<any>;
     /**
-     * Get global events with metadata
+     * Get global events with metadata (alias for getCurrent)
      */
     getGlobal(): Promise<any>;
     getSessions(params: {
@@ -35,12 +33,26 @@ export declare class TournamentsResource {
     }, fortniteToken: string): Promise<any>;
     /**
      * Get tournament leaderboard
-     * @param params.eventId - Event ID
-     * @param params.eventWindowId - Event window ID
+     *
+     * The `leaderboardDef` parameter serves two distinct purposes depending on the tournament type:
+     *
+     * **1. Ranked Cup (rank-tier leaderboards)**
+     * Pass the rank-tier def ID found in `eventWindow.metadata.defaultLeaderboardByRank`.
+     * The server resolves this to a different internal window ID to return rank-filtered results.
+     * Example: `"ranked_br_division_7"`
+     *
+     * **2. Cumulative leaderboard**
+     * Pass the cumulative def ID found in `eventWindow.scoreLocations` where
+     * `isMainWindowLeaderboard === false`. The server forwards this as Epic's `sm=` query param,
+     * returning the combined leaderboard across all sessions in the same group (e.g. Day 1 + Day 2).
+     * Example: `"S40_FNCSMajor1_PlayInStage_CumulativeLeaderboardDef"`
+     *
+     * @param params.eventId - Event ID (e.g. `"epicgames_S40_FNCSMajor1_PlayInStage_EU"`)
+     * @param params.eventWindowId - Event window ID (e.g. `"S40_FNCSMajor1_PlayInStage_Day1_EU"`)
      * @param params.page - Page number (default: 0)
-     * @param params.leaderboardDef - Optional leaderboard definition
-     * @param params.accountId - Optional account ID to highlight
-     * @param fortniteToken - Optional user's Fortnite token for personalized view
+     * @param params.leaderboardDef - Optional leaderboard definition ID (Ranked Cup tier or cumulative def)
+     * @param params.accountId - Optional account ID — highlights that player in the response
+     * @param fortniteToken - Optional user's Fortnite access token for personalized view
      */
     getLeaderboard(params: {
         eventId: string;

package/dist/resources/tournaments.js

@@ -6,21 +6,19 @@ class TournamentsResource {
         this.client = client;
     }
     /**
-     * Get current events
-     * No parameters needed - uses API's default account
+     * Get currently active and upcoming tournaments, enriched with CMS metadata
      */
     async getCurrent() {
-        return this.client.request("/events/data/current");
+        return this.client.request("/events/global");
     }
     /**
-     * Get past events
-     * No parameters needed - uses API's default account
+     * Get all tournaments including past ones, enriched with CMS metadata
      */
     async getPast() {
-        return this.client.request("/events/data/past");
+        return this.client.request("/events/global/history");
     }
     /**
-     * Get global events with metadata
+     * Get global events with metadata (alias for getCurrent)
      */
     async getGlobal() {
         return this.client.request("/events/global");
@@ -43,7 +41,7 @@ class TournamentsResource {
             region: params.region,
             platform: params.platform,
         }).toString();
-        return this.client.request(`/events/download?${query}`, {
+        return this.client.request(`/events/player?${query}`, {
             headers: {
                 "x-fortnite-token": fortniteToken,
             },
@@ -51,12 +49,26 @@ class TournamentsResource {
     }
     /**
      * Get tournament leaderboard
-     * @param params.eventId - Event ID
-     * @param params.eventWindowId - Event window ID
+     *
+     * The `leaderboardDef` parameter serves two distinct purposes depending on the tournament type:
+     *
+     * **1. Ranked Cup (rank-tier leaderboards)**
+     * Pass the rank-tier def ID found in `eventWindow.metadata.defaultLeaderboardByRank`.
+     * The server resolves this to a different internal window ID to return rank-filtered results.
+     * Example: `"ranked_br_division_7"`
+     *
+     * **2. Cumulative leaderboard**
+     * Pass the cumulative def ID found in `eventWindow.scoreLocations` where
+     * `isMainWindowLeaderboard === false`. The server forwards this as Epic's `sm=` query param,
+     * returning the combined leaderboard across all sessions in the same group (e.g. Day 1 + Day 2).
+     * Example: `"S40_FNCSMajor1_PlayInStage_CumulativeLeaderboardDef"`
+     *
+     * @param params.eventId - Event ID (e.g. `"epicgames_S40_FNCSMajor1_PlayInStage_EU"`)
+     * @param params.eventWindowId - Event window ID (e.g. `"S40_FNCSMajor1_PlayInStage_Day1_EU"`)
      * @param params.page - Page number (default: 0)
-     * @param params.leaderboardDef - Optional leaderboard definition
-     * @param params.accountId - Optional account ID to highlight
-     * @param fortniteToken - Optional user's Fortnite token for personalized view
+     * @param params.leaderboardDef - Optional leaderboard definition ID (Ranked Cup tier or cumulative def)
+     * @param params.accountId - Optional account ID — highlights that player in the response
+     * @param fortniteToken - Optional user's Fortnite access token for personalized view
      */
     async getLeaderboard(params, fortniteToken) {
         const { eventId, eventWindowId, page = 0, leaderboardDef, accountId, } = params;
@@ -78,7 +90,7 @@ class TournamentsResource {
                 },
             }
             : undefined;
-        return this.client.request(`/events/leaderboard?${query.toString()}`, options);
+        return this.client.request(`/events/global/leaderboard?${query.toString()}`, options);
     }
     /**
      * Get tournament participation history for a player
@@ -87,7 +99,7 @@ class TournamentsResource {
      * @param fortniteToken - User's Fortnite access token (from OAuth flow)
      */
     async getTracker(accountId, fortniteToken) {
-        return this.client.request(`/tournament-tracker?accountId=${accountId}`, {
+        return this.client.request(`/events/tracker?accountId=${accountId}`, {
             headers: {
                 "x-fortnite-token": fortniteToken,
             },
@@ -110,7 +122,7 @@ class TournamentsResource {
         if (options?.requiredTournaments) {
             params.append("requiredTournaments", options.requiredTournaments.toString());
         }
-        return this.client.request(`/tournament-eligibility?${params.toString()}`, {
+        return this.client.request(`/events/tracker/eligibility?${params.toString()}`, {
             headers: {
                 "x-fortnite-token": fortniteToken,
             },

package/dist/resources/weapons.d.ts

@@ -1,5 +1,5 @@
 import { FortniteAPI } from "../client";
-import { WeaponsResponse } from "../types";
+import { WeaponsResponse, RarityDefinitionsResponse } from "../types";
 export declare class WeaponsResource {
     private client;
     constructor(client: FortniteAPI);
@@ -26,4 +26,8 @@ export declare class WeaponsResource {
         ammoType?: string;
         season?: string;
     }): Promise<WeaponsResponse>;
+    /**
+     * Get rarity definitions (colors, display names, backend values)
+     */
+    getRarityDefinitions(): Promise<RarityDefinitionsResponse>;
 }

package/dist/resources/weapons.js

@@ -39,5 +39,11 @@ class WeaponsResource {
         const query = params.toString() ? `?${params.toString()}` : "";
         return this.client.request(`/weapons${query}`, {}, "v2");
     }
+    /**
+     * Get rarity definitions (colors, display names, backend values)
+     */
+    async getRarityDefinitions() {
+        return this.client.request("/weapons/rarity", {}, "v2");
+    }
 }
 exports.WeaponsResource = WeaponsResource;

package/dist/types/index.d.ts

@@ -720,6 +720,18 @@ export interface CosmeticsSearchParams {
     rarity?: string;
     set?: string;
     search?: string;
+    season?: number;
+    chapter?: number;
+}
+export interface RarityDefinition {
+    value: string;
+    displayValue: string;
+    backendValue: string;
+    color: string;
+}
+export interface RarityDefinitionsResponse {
+    status: number;
+    data: RarityDefinition[];
 }
 export interface CrewPackResponse {
     status: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yaelouuu/fortnite-api",
-  "version": "5.0.0",
+  "version": "6.0.0",
   "description": "SDK for Fortnite Tournaments API by Royal Arena - Author : Yael Brinkert",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",