Web Playground

MLBB Endpoint

Interactive request form for this API endpoint.

Each card below maps directly to an API endpoint. Query, path, and request body fields are generated from OpenAPI.

GET Hero Position Filters

/web/mlbb/heroes/positions

Open Only This

Filter heroes by their position on the map using role and lane criteria. Supports multiple query parameters for roles and lanes, along with pagination, sorting, and localization.

Query parameters:

  • role: Role filter (multi allowed). Values: tank, fighter, assassin, mage, marksman, support.

Example: role=tank&role=fighter

  • lane: Lane filter (multi allowed). Values: exp, mid, roam, jungle, gold.

Example: lane=exp&lane=mid

  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • order: Sort order for results. Allowed values: asc, desc.
  • lang: Language code for localized content (default: en).

The response includes hero position data:

  • records: Array of hero entries, each containing:
      • data:
          • hero:
              • data:
                  • name: Hero name.
                  • smallmap: Hero smallmap image URL.
                  • roadsort: Array of lane metadata objects:
                      • _id: Unique identifier.
                      • caption: Lane caption (localized).
                      • configId: Configuration ID.
                      • createdAt: Creation timestamp.
                      • createdUser: Creator username.
                      • data:
                          • _object: Object reference ID.
                          • road_sort_icon: Lane icon URL.
                          • road_sort_id: Lane ID.
                          • road_sort_title: Lane title (e.g., Roam).
                      • updatedAt: Last update timestamp.
                      • updatedUser: Last updater username.
                  • sortid: Array of role metadata objects:
                      • _id: Unique identifier.
                      • caption: Role caption (localized).
                      • configId: Configuration ID.
                      • createdAt: Creation timestamp.
                      • createdUser: Creator username.
                      • data:
                          • _object: Object reference ID.
                          • sort_icon: Role icon URL.
                          • sort_id: Role ID.
                          • sort_title: Role title (e.g., Support).
                      • updatedAt: Last update timestamp.
                      • updatedUser: Last updater username.
          • hero_id: Unique hero identifier.
          • relation:
              • assist:
                  • target_hero_id: Array of hero IDs assisted.
              • strong:
                  • target_hero_id: Array of hero IDs this hero is strong against.
              • weak:
                  • target_hero_id: Array of hero IDs this hero is weak against.
      • id: Record identifier.

This endpoint is useful for:

  • Building filtered hero lists.
  • Analyzing hero roles and lane assignments.
  • Understanding hero relationships (assist, strong, weak).
role query

Filter heroes by role.

lane query

Filter heroes by lane.

size query

Number of items per page. Minimum: 1.

index query

Page index for pagination. Minimum: 1.

order query

Sort order by hero ID.

lang query

Language code for localized content.

GET /api/heroes/positions