# metaobjectByHandle - admin - QUERY
Version: 2025-01

## Description
Retrieves a metaobject by handle.

### Access Scopes
`read_metaobjects` access scope.


## Arguments
* [handle](/docs/api/admin/2025-01/input-objects/MetaobjectHandleInput): MetaobjectHandleInput! - The identifier of the metaobject to return.


## Returns
* [capabilities](/docs/api/admin/2025-01/objects/MetaobjectCapabilityData): MetaobjectCapabilityData! Metaobject capabilities for this Metaobject.
* [createdBy](/docs/api/admin/2025-01/objects/App): App! The app used to create the object.
* [createdByApp](/docs/api/admin/2025-01/objects/App): App! The app used to create the object.
* [createdByStaff](/docs/api/admin/2025-01/objects/StaffMember): StaffMember The staff member who created the metaobject.
* [definition](/docs/api/admin/2025-01/objects/MetaobjectDefinition): MetaobjectDefinition! The MetaobjectDefinition that models this object type.
* [displayName](/docs/api/admin/2025-01/scalars/String): String! The preferred display name field value of the metaobject.
* [field](/docs/api/admin/2025-01/objects/MetaobjectField): MetaobjectField The field for an object key, or null if the key has no field definition.
* [fields](/docs/api/admin/2025-01/objects/MetaobjectField): MetaobjectField! All ordered fields of the metaobject with their definitions and values.
* [handle](/docs/api/admin/2025-01/scalars/String): String! The unique handle of the object, useful as a custom ID.
* [id](/docs/api/admin/2025-01/scalars/ID): ID! A globally-unique ID.
* [staffMember](/docs/api/admin/2025-01/objects/StaffMember): StaffMember The staff member who created the metaobject.
* [thumbnailField](/docs/api/admin/2025-01/objects/MetaobjectField): MetaobjectField The recommended field to visually represent this metaobject. May be a file reference or color         field.
* [type](/docs/api/admin/2025-01/scalars/String): String! The type of the metaobject.
* [updatedAt](/docs/api/admin/2025-01/scalars/DateTime): DateTime! When the object was last updated.


## Examples