API Documentation - Fortnite API Endpoints & SDKs

Quick start

Up and running in 4 steps

1Create a free account on api-fortnite.com.
2Open your dashboard and copy your personal API key.
3Include your key in the x-api-key header on every request.
4Hit any endpoint — JSON in milliseconds, rate-limit headers on every response.

terminal · curl

# Get today's item shop
curl -H "x-api-key: YOUR_KEY" \
  https://prod.api-fortnite.com/api/v1/shop

Endpoints

A taste of the surface

Player Stats & Profiles

Retrieve detailed player statistics including wins, kills, K/D ratio, matches played, ranked progress, and more for any Fortnite player.

/api/v2/stats/:accountId/api/v1/profile/progress?displayName=.../api/v1/profile/stats?displayName=...&timeWindow=season

Item Shop

Get the current Fortnite item shop rotation with prices, rarity, images, and metadata for every item available today.

/api/v1/shop

Cosmetics

Browse the full Fortnite cosmetics catalog including skins, emotes, pickaxes, gliders, wraps, and back blings.

/api/v2/cosmetics/api/v2/cosmetics/:id

Weapons & Items

Access weapon stats, damage values, fire rates, rarity, and images. Filter by season or get all weapons including unversioned items.

/api/v2/weapons?version=current/api/v2/weapons?version=all/api/v2/weapons?category=shotguns&search=pump

Sprites

The seasonal Sprites catalog, self-extracted from game files: every sprite family and variant with rarity, icons, boons, and live drop rates — Epic's hotfix overlay is applied so Power-Hour and event weight rotations show up in real time.

/api/v2/sprites/api/v2/sprites?variant=gold/api/v2/sprites/DuckSprite/api/v2/sprites/boons

Tournaments & Events

Fetch tournament data, leaderboards, eligibility requirements, event windows, scoring rules, and player participation history.

/api/v2/events/:eventId/windows/api/v2/events/:eventId/eligibility/api/v2/events/:eventId/eligibility/:accountId

Friends & Social

Access friend lists, incoming/outgoing requests, mutual friends, blocklist, and suggested friends. Requires user OAuth token.

/api/v1/friends/:accountId/summary/api/v1/friends/:accountId/friends

Map & POIs

Named POIs with world coordinates for every map in a patch — Battle Royale, OG, and each Reload/Blitz rotating map — selected with ?mode=. Responses include worldBounds and image dimensions so coordinates convert straight to pixels. 221 versions from Chapter 1 Season 1 to the current patch.

/api/v1/map/api/v1/map?mode=og/api/v1/map?mode=rotating:blastberry/api/v1/map?version=33.00/api/v1/map/image?mode=og/api/v1/map/history?chapter=6

Specialized

Guides & deep dives

Replay Parser

Parse Fortnite .replay files via API. Extract match stats, player lobbies, storm zones, map data, timelines, and ground loot. Supports both client replays (file upload) and tournament server replays (fetch-and-parse by match ID).

StatsLobbyMapZonesTimelineLootBroadcastTournament

Reference

Full API spec & SDKs

For complete request / response schemas, error codes, and interactive testing, the canonical reference is split across two surfaces.

API Reference

OpenAPI / Swagger with interactive endpoint testing and full request-response schemas.

prod.api-fortnite.com/swagger

Typescript SDK & Libraries

Official SDK for TypeScript. Type-safe clients, examples, and migration notes.

sdk.api-fortnite.com

Python SDKs & Libraries

Official SDK for Python. Type-safe clients, examples, and migration notes.

pypi.org/project/fortnite-api-sdk/

Authentication

One key, every endpoint

All API requests require a single key passed via the x-api-key header. Sign up to grab yours; rate limits depend on your plan — see pricing for the breakdown.

Support

Need help?

Join the Discord community to ask questions, request features, or chat with other developers building on the API. Prefer email? Reach out directly.

The Fortnite APIreference.