---
reference:
  curl:
    - key: read_object_by_name
      id: read_object_by_name
      url: /reference/vault/object/get-by-name
      title: '/vault/v1/kv/name/:name'
      type: GET
      parameters:
        - key: name
          type: string
          description: (object.name)
      returns:
        - (object)
  js:
    - key: readObjectByName
      id: read_object_by_name
      url: /reference/vault/object/get-by-name
      title: vault.readObjectByName()
      parameters:
        - key: name
          type: string
          description: (object.name)
      returns:
        - (Object)
  go:
    - key: ReadObjectByName
      id: read_object_by_name
      url: /reference/vault/object/get-by-name
      title: vault.ReadObjectByName()
      parameters:
        - (ctx)
        - key: opts
          type: vault.ReadObjectByNameOpts
          expanded: true
          properties:
            - (Object.Name)
      returns:
        - (Object)
  python:
    - key: read_object_by_name
      id: read_object_by_name
      url: /reference/vault/object/get-by-name
      title: vault.read_object_by_name()
      parameters:
        - key: name
          type: str
          description: (object.name)
      returns:
        - (VaultObject)
originalPath: .tmp-workos-clone/packages/docs/content/reference/vault/object/get-by-name.mdx
---

## Get an object by name

Get an existing object by its name. The stored value will be decrypted and returned.

<CodeBlock referenceId="read_object_by_name">
  <CodeBlockTab title="Request" file="get-object-by-name-request" />
  <CodeBlockTab title="Response" file="get-object-full-response" />
</CodeBlock>