Skip to main content
The Maps API gives you access to every playable and practice map in Valorant, including minimap images and normalized callout location data. You can retrieve the full list of maps or look up a specific map by its UUID. Each map object includes display assets, geographic coordinates, minimap scaling multipliers, and an array of named callout regions with their positions on the minimap.
The User-Agent header is required for all requests. Use the format AppName/Version (+URL) — for example, MyApp/1.0 (+https://example.com).

​
Endpoints

MethodPathDescription
GET/v1/mapsReturns all maps
GET/v1/maps/{uuid}Returns a single map by UUID

​
GET /v1/maps

Returns an array of all Valorant maps, including playable and practice maps.

​
Request parameters

​
User-Agent
string
required
Identifies your application. Format: AppName/Version (+URL).
​
language
string
default:"en-US"
Locale for localized display names and descriptions. Example: ja-JP, de-DE.

​
Example request

curl --request GET \
  --url "https://astra.teamfortuna.xyz/v1/maps" \
  --header "User-Agent: MyApp/1.0 (+https://example.com)"

​
Response

{
  "status": 200,
  "data": [
    {
      "uuid": "224b0a95-48b9-f703-1bd8-67aca101a61f",
      "displayName": "アビス",
      "narrativeDescription": "",
      "tacticalDescription": "",
      "coordinates": "70° 50' AJ\" N, 9° 00' VX\" W",
      "displayIcon": "https://valmedia.teamfortuna.xyz/maps/224b0a95-48b9-f703-1bd8-67aca101a61f/displayicon.png",
      "listViewIcon": "https://valmedia.teamfortuna.xyz/maps/224b0a95-48b9-f703-1bd8-67aca101a61f/listviewicon.png",
      "listViewIconTall": null,
      "splash": "https://valmedia.teamfortuna.xyz/maps/224b0a95-48b9-f703-1bd8-67aca101a61f/levelsplashscreen.png",
      "stylizedBackgroundImage": "https://valmedia.teamfortuna.xyz/maps/224b0a95-48b9-f703-1bd8-67aca101a61f/stylizedbackgroundimage.png",
      "premierBackgroundImage": null,
      "assetPath": "ShooterGame/Content/Maps/Infinity/Infinity_PrimaryAsset",
      "mapUrl": "/Game/Maps/Infinity/Infinity",
      "xMultiplier": 0.000081,
      "xScalarToAdd": 0.5,
      "yMultiplier": -0.000081,
      "yScalarToAdd": 0.5,
      "callouts": null
    }
  ]
}

​
GET /v1/maps/

Returns a single map matching the provided UUID.

​
Request parameters

​
uuid
string
required
The UUID of the map to retrieve.
​
User-Agent
string
required
Identifies your application. Format: AppName/Version (+URL).
​
language
string
default:"en-US"
Locale for localized display names and descriptions.

​
Example request

cURL
curl --request GET \
  --url "https://astra.teamfortuna.xyz/v1/maps/7eaecc1b-4337-bbf6-6ab9-04b8f06b3319" \
  --header "User-Agent: MyApp/1.0 (+https://example.com)"

​
Response

{
  "status": 200,
  "data": {
    "uuid": "7eaecc1b-4337-bbf6-6ab9-04b8f06b3319",
    "displayName": "Ascent",
    "narrativeDescription": "",
    "tacticalDescription": "",
    "coordinates": "45°26'BF'N,12°20'Q'E",
    "displayIcon": "https://valmedia.teamfortuna.xyz/maps/7eaecc1b-4337-bbf6-6ab9-04b8f06b3319/displayicon.png",
    "listViewIcon": "https://valmedia.teamfortuna.xyz/maps/7eaecc1b-4337-bbf6-6ab9-04b8f06b3319/listviewicon.png",
    "listViewIconTall": null,
    "splash": "https://valmedia.teamfortuna.xyz/maps/7eaecc1b-4337-bbf6-6ab9-04b8f06b3319/levelsplashscreen.png",
    "stylizedBackgroundImage": "https://valmedia.teamfortuna.xyz/maps/7eaecc1b-4337-bbf6-6ab9-04b8f06b3319/stylizedbackgroundimage.png",
    "premierBackgroundImage": null,
    "assetPath": "ShooterGame/Content/Maps/Ascent/Ascent_PrimaryAsset",
    "mapUrl": "/Game/Maps/Ascent/Ascent",
    "xMultiplier": 0.00007,
    "xScalarToAdd": 0.813895,
    "yMultiplier": -0.00007,
    "yScalarToAdd": 0.573242,
    "callouts": null
  }
}

​
Response fields

​
uuid
string
required
Unique identifier for the map.
​
displayName
string
required
The map’s localized display name (e.g., "Ascent").
​
narrativeDescription
string
Lore-flavored description. May be null.
​
tacticalDescription
string
Short tactical summary, typically indicating the number of bomb sites (e.g., "2 Sites"). May be null.
​
coordinates
string
Real-world geographic coordinates tied to the map’s fictional setting. May be null.
​
displayIcon
string
URL to the map’s primary display icon image.
​
listViewIcon
string
URL to the map icon used in list views.
​
splash
string
URL to the full-width splash art for the map.
​
assetPath
string
Internal Unreal Engine asset path.
​
mapUrl
string
Internal game path used to reference the map.
​
xMultiplier
number
Multiplier used to convert a world-space X coordinate to a normalized minimap X position.
​
yMultiplier
number
Multiplier used to convert a world-space Y coordinate to a normalized minimap Y position.
​
xScalarToAdd
number
Offset added after applying xMultiplier to produce the final normalized X coordinate.
​
yScalarToAdd
number
Offset added after applying yMultiplier to produce the final normalized Y coordinate.
​
callouts
object[]
Array of named map regions with their minimap positions.
To place a callout marker on a minimap image, multiply the normalized x and y values by your image’s pixel width and height respectively.