Metaplex

Methods & Playground

Get Grouping

Last updated July 6, 2026

Summary

The getGrouping DAS API method returns metadata for a group key/value pair without listing every member.

  • Returns group_key, group_name, and group_size for the queried group
  • Use groupKey: "collection" for Token Metadata and mpl-core collections
  • Use groupKey: "group" for mpl-core GroupV1 accounts that group collections, assets, and nested groups
  • To list individual members, use getAssetsByGroup

Parameters

NameRequiredDescription
groupKey✅The key of the group (e.g., "collection" or "group" for mpl-core groups).
groupValue✅The value of the group (e.g., collection or mpl-core group address).

Response

The response includes:

  • group_key - The group key that was queried
  • group_name - Display name for the group when available
  • group_size - Number of indexed members in the group

Playground

Notes

  • getGrouping returns summary metadata only — use getAssetsByGroup to paginate through group members
  • group_size reflects the number of members indexed by DAS for the given groupKey/groupValue pair
  • For mpl-core GroupV1 groups, indexed members may include collections, assets, and nested groups depending on what the indexer has recorded
Next
Get Assets By Owner