---
descriptions:
  updatedAfter: >-
    ISO 8601 timestamp used to filter results. Only objects updated after this
    timestamp will be returned.
reference:
  curl:
    - key: list_objects
      id: list_objects
      url: /reference/vault/object/list
      title: /vault/v1/kv
      type: GET
      parameters:
        - (limit)
        - (before)
        - (after)
        - key: updatedAfter
          optional: true
          type: DateTime
          description: (updatedAfter)
      returns:
        - key: anonymous
          type: object
          unwrap: true
          properties:
            - key: data
              type: array
              properties:
                - (object.id)
                - (object.name)
                - key: updated_at
                  type: string
                  description: (object_metadata.updated_at)
            - key: list_metadata
              type: object
              properties:
                - (after)
                - (before)
  js:
    - key: listObjects
      id: list_objects
      url: /reference/vault/object/list
      title: vault.listObjects()
      parameters:
        - key: options
          type: object
          unwrap: true
          optional: true
          properties:
            - (limit)
            - (before)
            - (after)
      returns:
        - key: anonymous
          type: object
          unwrap: true
          properties:
            - key: data
              type: array
              properties:
                - (Object.id)
                - (Object.name)
                - key: updatedAt
                  type: string
                  description: (object_metadata.updated_at)
            - key: listMetadata
              type: object
              properties:
                - (after)
                - (before)
  go:
    - key: ListObjects
      id: list_objects
      url: /reference/vault/object/list
      title: vault.ListObjects()
      parameters:
        - (ctx)
        - key: opts
          type: vault.ListObjectsOpts
          expanded: true
          properties:
            - (Limit)
            - (Before)
            - (After)
      returns:
        - key: listResponse
          type: vault.ListObjectsResponse
          unwrap: true
          properties:
            - key: data
              type: 'vault.ObjectDigest[]'
              properties:
                - (Object.Id)
                - (Object.Name)
                - key: UpdatedAt
                  type: time.Time
                  description: (object_metadata.updated_at)
            - key: ListMetadata
              type: ListMetadata
              properties:
                - (Before)
                - (After)
  python:
    - key: list_objects
      id: list_objects
      url: /reference/vault/object/list
      title: vault.list_objects()
      parameters:
        - (limit)
        - (before)
        - (after)
      returns:
        - key: paginated_objects
          type: vault.VaultObjectList
          unwrap: true
          properties:
            - key: data
              type: 'vault.ObjectDigest[]'
              properties:
                - key: id
                  type: str
                  description: (object.id)
                - key: name
                  type: str
                  description: (object.name)
                - key: updated_at
                  type: str
                  description: (object_metadata.updated_at)
            - key: ListMetadata
              type: ListMetadata
              properties:
                - (before)
                - (after)
originalPath: .tmp-workos-clone/packages/docs/content/reference/vault/object/list.mdx
---

## List objects

Get list of object names stored in Vault.

<CodeBlock referenceId="list_objects">
  <CodeBlockTab title="Request" file="list-objects-request" />
  <CodeBlockTab title="Response" file="list-objects-response" />
</CodeBlock>