Pathgen API Documentation

Everything you need to build on top of Fortnite's data layer. High-fidelity telemetry, player intelligence, and AI-powered strategy.

Introduction

Pathgen is a Fortnite data API that gives developers access to replay parsing, player stats, AI coaching, tournament analytics, and game metadata through a single API key and credit system. Some endpoints are free with no key required, while professional-grade endpoints utilize credits.Jump to Quickstart →

Getting Started

Base URL

api.pathgen.dev/v1

Authentication

Paid endpoints require an API key passed as a Bearer token in the Authorization header. Free public data endpoints require no key.

Authorization: Bearer rs_your_key_here

Get your key at platform.pathgen.dev/keys

Credits

Credits are purchased in packs. Charges only occur on successful (200 OK) responses. Failed parses or server errors are never billed.

DEVELOPER STARTER

$10.00

1000 Credits

SCALE-UP

$45.00

5000 Credits

HIGH FREQUENCY

$150.00

20000 Credits

Request Format

Replay endpoints use multipart/form-data with the file in a field called replay. All other endpoints use JSON or Query Params.

SUCCESS RESPONSE

{ "credits_used": 20, "credits_remaining": 1430, "data": { ... } }

ERROR RESPONSE

{ "error": true, "code": "INVALID_KEY", "message": "The provided key is invalid." }

Error Codes

Code	Status	Cause & Handling
`INVALID_KEY`	401	Missing or malformed API key. Check your Bearer token in the header.
`INSUFFICIENT_CREDITS`	402	Account balance is zero. Top up credits in the dashboard.
`NO_FILE`	400	The "replay" field is empty. Include a .replay file in form-data.
`INVALID_FILE`	415	The file uploaded is not a .replay file. Upload a valid Fortnite replay binary.
`UNSUPPORTED_VERSION`	422	Replay from a very old season. We support Ch4 and onwards.
`FILE_TOO_LARGE`	413	File exceeds 50MB limit. Use smaller replays or compress data.
`PARSE_FAILED`	500	Internal binary parsing logic error. Report to staff on Discord.
`RATE_LIMITED`	429	Burst RPM threshold exceeded. Check Retry-After header and wait.
`NOT_FOUND`	404	Match ID or Account ID not found. Verify the ID and try again.
`INVALID_PARAM`	400	Missing or invalid query parameter. Check the endpoint documentation.
`MAX_KEYS_REACHED`	403	Limit of 5 API keys reached. Revoke an existing key first.
`EPIC_NOT_CONNECTED`	403	Phase 2 data requires Epic login. Call /v1/epic/auth-url first.
`REPLAY_NOT_FOUND`	404	Replay file not found on Epic CDN. Only server replays can be auto-fetched.
`MATCH_STILL_LIVE`	400	Cannot parse a live match. Wait until the match concludes.

Rate Limits

Tier / Endpoint	Limit	Scope
No API Key	30 per min	Global / IP
Free (with Key)	60 per min	API Key
Replay Endpoints	20 per min	API Key
AI Coaching	5 per hr	API Key