---
descriptions:
  list_object_versions:
    data: >-
      Array of [object versions](/reference/vault/object/version) ordered by
      creation time.
reference:
  curl:
    - key: list_object_versions
      id: list_object_versions
      url: /reference/vault/object/versions
      title: '/vault/v1/kv/:id/versions'
      type: GET
      parameters:
        - (object.id)
      returns:
        - key: anonymous
          type: object
          unwrap: true
          properties:
            - key: data
              type: array
              description: (list_object_versions.data)
            - key: list_metadata
              type: object
              properties:
                - (after)
                - (before)
  js:
    - key: listObjectVersions
      id: list_object_versions
      url: /reference/vault/object/versions
      title: vault.listObjectVersions()
      parameters:
        - key: options
          type: object
          unwrap: true
          properties:
            - (Object.id)
      returns:
        - key: anonymous
          type: object
          unwrap: true
          properties:
            - key: data
              type: 'ObjectVersion[]'
              description: (list_object_versions.data)
            - key: listMetadata
              type: object
              properties:
                - (after)
                - (before)
  go:
    - key: ListObjectVersions
      id: list_object_versions
      url: /reference/vault/object/versions
      title: vault.ListObjectVersions()
      parameters:
        - (ctx)
        - key: opts
          type: vault.ReadObjectOpts
          expanded: true
          properties:
            - (Object.Id)
      returns:
        - key: listResponse
          type: vault.ListObjectVersionsResponse
          unwrap: true
          properties:
            - key: data
              type: 'ObjectVersion[]'
              description: (list_object_versions.data)
  python:
    - key: list_object_versions
      id: list_object_versions
      url: /reference/vault/object/versions
      title: vault.list_object_versions()
      parameters:
        - key: object_id
          type: str
          description: (object.id)
      returns:
        - key: data
          type: 'ObjectVersion[]'
          description: (list_object_versions.data)
originalPath: .tmp-workos-clone/packages/docs/content/reference/vault/object/versions.mdx
---

## List object versions

Get list of versions for an object stored in Vault.

<CodeBlock referenceId="list_object_versions">
  <CodeBlockTab title="Request" file="list-object-versions-request" />
  <CodeBlockTab title="Response" file="list-object-versions-response" />
</CodeBlock>