---
reference:
  curl:
    - key: describe_object
      id: describe_object
      url: /reference/vault/object/metadata
      title: '/vault/v1/kv/:id/metadata'
      type: GET
      parameters:
        - (object.id)
      returns:
        - (object.id)
        - (object.name)
        - (object.metadata)
  js:
    - key: describeObject
      id: describe_object
      url: /reference/vault/object/metadata
      title: vault.describeObject()
      parameters:
        - key: options
          type: object
          unwrap: true
          properties:
            - (Object.id)
      returns:
        - (Object)
  go:
    - key: DescribeObject
      id: describe_object
      url: /reference/vault/object/metadata
      title: vault.DescribeObject()
      parameters:
        - (ctx)
        - key: opts
          type: vault.ReadObjectOpts
          expanded: true
          properties:
            - (Object.Id)
      returns:
        - (Object)
originalPath: .tmp-workos-clone/packages/docs/content/reference/vault/object/metadata.mdx
---

## Retrieve metadata

Retrieve metadata about an object. The value itself is not returned.

<CodeBlock referenceId="describe_object">
  <CodeBlockTab title="Request" file="describe-object-request" />
  <CodeBlockTab title="Response" file="get-object-response" />
</CodeBlock>