MarvelRivalsAPI.com
  1. Get Started
MarvelRivalsAPI.com
  • Introduction
  • Get Started
    • Authentication
    • Rate Limits
    • Errors
      • Status Codes
    • SDKs & Extentions
      • Community Libraries
  • Endpoints
    • Achievements
      • List achievements
      • Search achievement
    • Patch Notes
      • List balances
      • Search balance
      • List dev diaries
      • Search dev diary
      • List patch notes
      • Search patch note
      • List game versions
    • Battle Pass
      • Battlepass
    • Heroes
      • List Heroes
      • Search hero
      • Hero stats
      • Hero leaderboard
      • List costumes
      • Search hero costume
    • Items
      • List items
      • Search item
    • Maps
      • List maps
      • Search map
    • Player Match History
      • Search match
      • Player match history
      • Player match history v2
    • Player Stats
      • Search player
      • Player stats
      • Player stats v2
      • Update player
      • Player Leaderboard
  1. Get Started

Authentication

Marvel Rivals API requires an API key to authenticate every request. This key identifies your application, enforces rate limits, and determines your access tier.
All unauthenticated requests will be rejected with a 401 Unauthorized response.
See the Errors page for a list of common authentication-related responses.

How to Get Your API Key#

1.
Visit https://marvelrivalsapi.com/dashboard/settings
2.
Sign in or create an account
3.
Click "Generate Key" or use your existing key
Your key will look like this:
50aswrtfdhsfgjdfg12j321dxf2g1hjdfg2j12szxdf1h0sazdfh21bzsdfhszdf
The above example key is not a real key & will not work if used to make requests.

Using Your API Key#

You must include the key in the x-api-key header of every request. Here’s a full example:
curl -X GET "https://marvelrivalsapi.com/api/v1/maps" -H "x-api-key: 50aswrtfdhsfgjdfg12j321dxf2g1hjdfg2j12szxdf1h0sazdfh21bzsdfhszdf"
Modified at 2025-07-20 17:27:03
Previous
Introduction
Next
Rate Limits
Built with