APIs found

[LeleDerGrasshalmi]

👋 Welcome!

We’re using Discussions as a place to save apis where we may add documentation for at a later date

Create A Comment like this:

• Method
• Url
• Headers (optional)
• Body (if its a method that takes body but sents an empty one note that too)
• Context (Where / How the api is used)

[LeleDerGrasshalmi]

UEFN Auth for the URC - UCS API

1. You get 3e13c5c57f594a578abe516eecb673fe (UEFN Client) Authentication
2. GET https://urc-api.ucs.on.epicgames.com/v1/auth (WITH Authentication HEADER!)
3. use the token from the response for any requests made to that apis!

[LeleDerGrasshalmi]

UEFN News - Content API

GET https://fortnitecontent-website-prod07.ol.epicgames.com/content/api/pages/fortnite-editor?lang=en

[LeleDerGrasshalmi]

v24.10 Stuff

Get the Latest Host for your platform
GET https://fn-hotconfigs.ogs.live.on.epicgames.com/hotconfigs/v2/livefn.json

---

As always, you guys know epic doesnt like touching matchmaking stuff!

Get the GameSessionToken:
POST https://<HOST>/fortnite/api/gamesession/v1/account/:accountId/token/:sessionId

responds with:

{
    "token": "JWT"
}

JWT:

[Krowe-moh]

Nice

[LeleDerGrasshalmi]

V27.00

Discovery Search

POST https://fn-service-discovery-search-live-public.ogs.live.on.epicgames.com/api/v1/search?accountId=REDACTED HTTP/1.1
Host: fn-service-discovery-search-live-public.ogs.live.on.epicgames.com
Accept: */*
Accept-Encoding: deflate, gzip
Connection: Keep-Alive
Content-Type: application/json
X-Epic-Correlation-ID: FN-hi0Eeshvs0GzFwQMuooZYw
User-Agent: Fortnite/++Fortnite+Release-27.00-CL-29072304 Windows/10.0.19045.1.768.64bit
Authorization: bearer eg1~lele
Content-Length: 181

{
    "namespace": "fortnite",
    "context": [],
    "locale": "en-US-POSIX",
    "search": "ssaasaassaa",
    "orderBy": "globalCCU",
    "ratingAuthority": "",
    "rating": "",
    "page": 0
}

[LeleDerGrasshalmi]

V28.00 APIS

New News API for each gamemode (before there was just br)
https://prm-dialogue-public-api-prod.edea.live.use1a.on.epicgames.com/api/v1/fortnite-br/surfaces/stw-motd/target
https://prm-dialogue-public-api-prod.edea.live.use1a.on.epicgames.com/api/v1/fortnite-br/surfaces/sparks-motd/target
https://prm-dialogue-public-api-prod.edea.live.use1a.on.epicgames.com/api/v1/fortnite-br/surfaces/juno-motd/target
https://prm-dialogue-public-api-prod.edea.live.use1a.on.epicgames.com/api/v1/fortnite-br/surfaces/eco-motd/target
https://prm-dialogue-public-api-prod.edea.live.use1a.on.epicgames.com/api/v1/fortnite-br/surfaces/delmar-motd/target
https://prm-dialogue-public-api-prod.edea.live.use1a.on.epicgames.com/api/v1/fortnite-br/surfaces/br-motd/target

[LeleDerGrasshalmi]

Just found more MCP Operations, that apparently do the same as the WASP Service?
Unknown profile id, so we cannot test/document it yet really

• ProtoJuno_UpdateWorldSysMetadata (dedicated server, all others are client)
• ProtoJuno_UpdateWorldMetadata
• ProtoJuno_UpdateWorldLastAccessTime
• ProtoJuno_SetWorldName
• ProtoJuno_MarkWorldDeleted
• ProtoJuno_DeleteWorld
• ProtoJuno_DeleteAllWorlds
• ProtoJuno_CreateWorld

already tested many possible profileId values + checked account pdf, no new profile there

{
    "errorCode": "errors.com.epicgames.modules.profiles.invalid_command",
    "errorMessage": "ProtoJuno_UpdateWorldMetadata is not valid on player:profile_creative profiles (creative)",
    "messageVars": [
        "ProtoJuno_UpdateWorldMetadata",
        "player:profile_creative",
        "creative"
    ],
    "numericErrorCode": 12801,
    "originatingService": "fortnite",
    "intent": "prod-live"
}

painful

[LeleDerGrasshalmi]

Heres the payload data and route stuff for it:

ProtoJuno_UpdateWorldSysMetadata (dedicated_server)

{
   "worldId": "",
   "sysMetadata": {}
}

ProtoJuno_UpdateWorldMetadata (client)

{
   "worldId": "",
   "worldMetadata": {}
}

ProtoJuno_UpdateWorldLastAccessTime (client)

{
   "worldId": ""
}

ProtoJuno_SetWorldName (client)

{
   "worldId": "",
   "name": ""
}

ProtoJuno_MarkWorldDeleted (client)

{
   "worldId": ""
}

ProtoJuno_DeleteWorld (client)

{
   "worldId": ""
}

ProtoJuno_DeleteAllWorlds (client)

{}

ProtoJuno_CreateWorld (client)

{
   "world_metadata": {}
}

[LeleDerGrasshalmi]

I found the profileId, its proto_juno

[LeleDerGrasshalmi]

documented now!
2252328

[LeleDerGrasshalmi]

FN Festival (sparks) Songs and extra_video_vuids link UUIDs to vuid(s)
GET https://cdn.qstv.on.epicgames.com/:uuid example uuid is 74819302-b2a0-49ff-b315-207fb33dfbb6

which will respond with this json

{
    "playlist": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4KPE1QRCB4bWxucz0idXJuOm1wZWc6ZGFzaDpzY2hlbWE6bXBkOjIwMTEiIHhtbG5zOnhzaT0iaHR0cDovL3d3dy53My5vcmcvMjAwMS9YTUxTY2hlbWEtaW5zdGFuY2UiIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB4c2k6c2NoZW1hTG9jYXRpb249InVybjptcGVnOkRBU0g6c2NoZW1hOk1QRDoyMDExIGh0dHA6Ly9zdGFuZGFyZHMuaXNvLm9yZy9pdHRmL1B1YmxpY2x5QXZhaWxhYmxlU3RhbmRhcmRzL01QRUctREFTSF9zY2hlbWFfZmlsZXMvREFTSC1NUEQueHNkIiB4bWxuczpjbGVhcmtleT0iaHR0cDovL2Rhc2hpZi5vcmcvZ3VpZGVsaW5lcy9jbGVhcktleSIgeG1sbnM6Y2VuYz0idXJuOm1wZWc6Y2VuYzoyMDEzIiBwcm9maWxlcz0idXJuOm1wZWc6ZGFzaDpwcm9maWxlOmlzb2ZmLWxpdmU6MjAxMSIgdHlwZT0ic3RhdGljIiBtZWRpYVByZXNlbnRhdGlvbkR1cmF0aW9uPSJQVDMwLjY1MFMiIG1heFNlZ21lbnREdXJhdGlvbj0iUFQyLjAwMFMiIG1pbkJ1ZmZlclRpbWU9IlBUNC4wMDBTIj4KICA8QmFzZVVSTD5odHRwczovL2ZvcnRuaXRlLXZvZC5ha2FtYWl6ZWQubmV0L2hTamRhVVdqZ1RHanN2Z3djTS8xNzAwMjUwMDA2LzwvQmFzZVVSTD4KICA8UHJvZ3JhbUluZm9ybWF0aW9uPjwvUHJvZ3JhbUluZm9ybWF0aW9uPgogIDxQZXJpb2QgaWQ9IjAiIHN0YXJ0PSJQVDBTIj4KICAgIDxBZGFwdGF0aW9uU2V0IGlkPSIwIiBjb250ZW50VHlwZT0iYXVkaW8iIHN0YXJ0V2l0aFNBUD0iMSIgc2VnbWVudEFsaWdubWVudD0idHJ1ZSIgYml0c3RyZWFtU3dpdGNoaW5nPSJ0cnVlIj4KICAgICAgPFJlcHJlc2VudGF0aW9uIGlkPSIwIiBhdWRpb1NhbXBsaW5nUmF0ZT0iNDgwMDAiIGJhbmR3aWR0aD0iMTI4MDAwIiBtaW1lVHlwZT0iYXVkaW8vbXA0IiBjb2RlY3M9Im9wdXMiPgogICAgICAgIDxTZWdtZW50VGVtcGxhdGUgZHVyYXRpb249IjIwMDAwMDAiIHRpbWVzY2FsZT0iMTAwMDAwMCIgaW5pdGlhbGl6YXRpb249ImluaXRfJFJlcHJlc2VudGF0aW9uSUQkLm1wNCIgbWVkaWE9InNlZ21lbnRfJFJlcHJlc2VudGF0aW9uSUQkXyROdW1iZXIkLm00cyIgc3RhcnROdW1iZXI9IjEiPjwvU2VnbWVudFRlbXBsYXRlPgogICAgICAgIDxBdWRpb0NoYW5uZWxDb25maWd1cmF0aW9uIHNjaGVtZUlkVXJpPSJ1cm46bXBlZzpkYXNoOjIzMDAzOjM6YXVkaW9fY2hhbm5lbF9jb25maWd1cmF0aW9uOjIwMTEiIHZhbHVlPSIyIj48L0F1ZGlvQ2hhbm5lbENvbmZpZ3VyYXRpb24+CiAgICAgIDwvUmVwcmVzZW50YXRpb24+CiAgICAgIDxDb250ZW50UHJvdGVjdGlvbiBzY2hlbWVJZFVyaT0idXJuOm1wZWc6ZGFzaDptcDRwcm90ZWN0aW9uOjIwMTEiIHZhbHVlPSJjZW5jIiBjZW5jOmRlZmF1bHRfS0lEPSI5NWM5OGRhZi1kZmE2LTUyOTItNDA1Yy05NjVlZTlhMmQ4YTciPjwvQ29udGVudFByb3RlY3Rpb24+CiAgICAgIDxDb250ZW50UHJvdGVjdGlvbiBzY2hlbWVJZFVyaT0idXJuOnV1aWQ6ZTI3MTlkNTgtYTk4NS1iM2M5LTc4MWEtYjAzMGFmNzhkMzBlIiB2YWx1ZT0iQ2xlYXJLZXkxLjAiPgogICAgICAgIDxjbGVhcmtleTpMYXVybCBMaWNfdHlwZT0iRU1FLTEuMCI+a2V5LmtleTwvY2xlYXJrZXk6TGF1cmw+CiAgICAgIDwvQ29udGVudFByb3RlY3Rpb24+CiAgICA8L0FkYXB0YXRpb25TZXQ+CiAgPC9QZXJpb2Q+CjwvTVBEPg==",
    "playlistType": "application/dash+xml",
    "envelope": "AQ4OBQBF6P2nNKKs6VpSxxZgC2FzMNZkzRs2Tck0ox3N4SSHqMUSEtyRm0mb1Bo0KqrtIs3i5s+dUPT1jG+NoxmCkUOZQ2BpADl1BrSh2Y4efO+opTywcdByUfTKz6rqrzlyuL6DvMJdl55uDEeo+ixxUTeH6VWf0LGu4I6QYANLpEL+Os38kXC8twZsZi9g",
    "metadata": {
        "assetId": "",
        "baseUrls": ["https://fortnite-vod.akamaized.net/hSjdaUWjgTGjsvgwcM/1700250006/", "https://fortnite-vod.akamaized.net/hSjdaUWjgTGjsvgwcM/1700250006/"],
        "supportsCaching": true,
        "version": "1700250006"
    }
}

The playlist is base64 encoded xml

<?xml version="1.0" encoding="utf-8"?>
<MPD xmlns="urn:mpeg:dash:schema:mpd:2011" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xlink="http://www.w3.org/1999/xlink" xsi:schemaLocation="urn:mpeg:DASH:schema:MPD:2011 http://standards.iso.org/ittf/PubliclyAvailableStandards/MPEG-DASH_schema_files/DASH-MPD.xsd" xmlns:clearkey="http://dashif.org/guidelines/clearKey" xmlns:cenc="urn:mpeg:cenc:2013" profiles="urn:mpeg:dash:profile:isoff-live:2011" type="static" mediaPresentationDuration="PT30.650S" maxSegmentDuration="PT2.000S" minBufferTime="PT4.000S">
    <BaseURL>https://fortnite-vod.akamaized.net/hSjdaUWjgTGjsvgwcM/1700250006/</BaseURL>
    <ProgramInformation></ProgramInformation>
    <Period id="0" start="PT0S">
        <AdaptationSet id="0" contentType="audio" startWithSAP="1" segmentAlignment="true" bitstreamSwitching="true">
            <Representation id="0" audioSamplingRate="48000" bandwidth="128000" mimeType="audio/mp4" codecs="opus">
                <SegmentTemplate duration="2000000" timescale="1000000" initialization="init_$RepresentationID$.mp4" media="segment_$RepresentationID$_$Number$.m4s" startNumber="1"></SegmentTemplate>
                <AudioChannelConfiguration schemeIdUri="urn:mpeg:dash:23003:3:audio_channel_configuration:2011" value="2"></AudioChannelConfiguration>
            </Representation>
            <ContentProtection schemeIdUri="urn:mpeg:dash:mp4protection:2011" value="cenc" cenc:default_KID="95c98daf-dfa6-5292-405c-965ee9a2d8a7"></ContentProtection>
            <ContentProtection schemeIdUri="urn:uuid:e2719d58-a985-b3c9-781a-b030af78d30e" value="ClearKey1.0">
                <clearkey:Laurl Lic_type="EME-1.0">key.key</clearkey:Laurl>
            </ContentProtection>
        </AdaptationSet>
    </Period>
</MPD>

Which then has the actual vuid and the stream playlist data.

Normal links (mnemonics can also have such video uuids), like in this very shortened fn festival link data

{
    "mnemonic": "playlist_pilgrimquickplay",
    "metadata": {
        "extra_video_vuids": [
            "f243a189-50c0-48c1-b87a-bad0eff247f1"
        ]
    }
}

Now lets get back to Spark tracks, these are stored at https://fortnitecontent-website-prod07.ol.epicgames.com/content/api/pages/fortnite-game/spark-tracks?lang=en (you need to request the sub-page)
example response with only 1 example track, which is switchup

{
    "_title": "spark-tracks",
    "_noIndex": false,
    "_activeDate": "2023-10-06T04:15:09.015Z",
    "lastModified": "2023-12-06T19:08:22.338Z",
    "_locale": "en-US",
    "_templateName": "blank",
    "switchup": {
        "_title": "switchup",
        "track": {
            "tt": "Switch Up",
            "mm": "Minor",
            "ab": "Fortnite",
            "siv": "Vocals",
            "su": "574c5462-742a-46d5-bbe0-e9e1696cc188",
            "in": {
                "pb": 1,
                "pd": 2,
                "vl": 2,
                "pg": 3,
                "_type": "SparkTrackIntensities",
                "gr": 3,
                "ds": 2,
                "ba": 1
            },
            "ry": 2020,
            "mt": 130,
            "_type": "SparkTrack",
            "mu": "https://cdn2.unrealengine.com/qvttttuppst0nn0s-90e305f9e300.dat",
            "dn": 179,
            "sib": "Bass",
            "an": "Epic Games",
            "gt": [
                "Jam-LoopIsUnpitched-Beat"
            ],
            "sid": "Drum",
            "sig": "Keyboard",
            "au": "https://cdn2.unrealengine.com/kdoxeyxx2ke0ky1m-512x512-eeeb887c4206.png",
            "ti": "SparksSong:sid_placeholder_42",
            "qi": "{\"sid\":\"603c6f1c-5b2b-4d3f-9f1b-001399ce9258\",\"pid\":\"74819302-b2a0-49ff-b315-207fb33dfbb6\",\"title\":\"switchup\",\"tracks\":[{\"part\":\"ds\",\"channels\":[\"FL\",\"FR\"],\"vols\":[4,4]},{\"part\":\"bs\",\"channels\":[\"FL\",\"FR\"],\"vols\":[4,4]},{\"part\":\"gs\",\"channels\":[\"FL\",\"FR\"],\"vols\":[4,4]},{\"part\":\"vs\",\"channels\":[\"FL\",\"FR\"],\"vols\":[4,4]},{\"part\":\"fs\",\"channels\":[\"FL\",\"FR\"],\"vols\":[4,4]}],\"preview\":{\"starttime\":18.5}}",
            "jc": "0986-0411-9139",
            "sn": "switchup",
            "ge": [
                "DanceElectronic"
            ],
            "mk": "G"
        },
        "_noIndex": false,
        "_activeDate": "2023-10-10T15:23:58.784Z",
        "lastModified": "2023-11-28T15:32:40.599Z",
        "_locale": "en-US",
        "_templateName": "track"
    }
    "_noIndex": false,
    "_activeDate": "2023-10-25T14:25:08.357Z",
    "lastModified": "2023-12-06T19:08:22.338Z",
    "_locale": "en-US",
    "_templateName": "track"
},

The stringified json at the path in track/ and then the qi property contains 2 interesting properties:

• sid
• pid

these are both uuids for the endpoint above to get the vuid/stream data

[LeleDerGrasshalmi]

v33.00 - new mcp operation that controls auto claiming battle passes

SetSeasonPassAutoClaim (athena)

{
    "seasonIds": ["br"],
    "bEnabled": true
}

this is stored inside the auto_spend_season_currency_ids profile stat (array)