Skip to main content
`Ctrl`+`K`

# pandas.MultiIndex.get_loc

MultiIndex.get_loc(key)

  Get location for a label or a tuple of labels. The location is returned as an integer/slice or boolean mask.

  This method returns the integer location, slice object, or boolean mask corresponding to the specified key, which can be a single label or a tuple of labels. The key represents a position in the MultiIndex, and the location indicates where the key is found within the index.

  Parameters:
    key label or tuple of labels (one for each level)

      A label or tuple of labels that correspond to the levels of the MultiIndex. The key must match the structure of the MultiIndex.

  Returns:
    int, slice object or boolean mask

      If the key is past the lexsort depth, the return may be a boolean mask array, otherwise it is always a slice or int.

  See also

  `Index.get_loc`

    The get_loc method for (single-level) index.

  `MultiIndex.slice_locs`

    Get slice location given start label(s) and end label(s).

  `MultiIndex.get_locs`

    Get location for a label/slice/list/mask or a sequence of such.

  Notes

  The key cannot be a slice, list of same-level labels, a boolean mask, or a sequence of such. If you want to use those, use `MultiIndex.get_locs()` instead.

  Examples

      >>> mi = pd.MultiIndex.from_arrays([list("abb"), list("def")])

      >>> mi.get_loc("b")
      slice(1, 3, None)

      >>> mi.get_loc(("b", "e"))
      1