---
descriptions:
  list_users:
    type: Filter users by their type.
    email: Filter users by their email.
    organization_id: Filter users by the organization they are members of.
    data: 'Array of [users](/reference/authkit/user) ordered by creation time.'
reference:
  curl:
    - key: list_users
      id: list_users
      url: /reference/authkit/user/list
      title: /user_management/users
      type: GET
      parameters:
        - key: email
          optional: true
          type: string
          description: (list_users.email)
        - key: organization_id
          optional: true
          type: string
          description: (list_users.organization_id)
        - (limit)
        - (before)
        - (after)
        - (order)
      returns:
        - key: anonymous
          type: object
          unwrap: true
          properties:
            - key: data
              type: array
              description: (list_users.data)
            - key: list_metadata
              type: object
              properties:
                - (before)
                - (after)
  js:
    - key: listUsers
      patternBefore: userManagement.
      id: list_users
      url: /reference/authkit/user/list
      title: userManagement.listUsers()
      parameters:
        - key: options
          type: object
          unwrap: true
          properties:
            - key: email
              optional: true
              type: string
              description: (list_users.email)
            - key: organizationId
              optional: true
              type: string
              description: (list_users.organization_id)
            - (limit)
            - (before)
            - (after)
            - (order)
      returns:
        - key: anonymous
          type: object
          unwrap: true
          properties:
            - key: data
              type: 'User[]'
              description: (list_users.data)
            - key: listMetadata
              type: object
              properties:
                - (before)
                - (after)
  go:
    - key: ListUsers
      patternBefore: usermanagement.
      id: list_users
      url: /reference/authkit/user/list
      title: usermanagement.ListUsers()
      parameters:
        - (ctx)
        - key: opts
          type: usermanagement.ListUsersOpts
          unwrap: true
          properties:
            - key: Email
              optional: true
              type: string
              description: (list_users.email)
            - key: Organization
              optional: true
              type: string
              description: (list_users.organization_id)
            - (Limit)
            - (Before)
            - (After)
            - (Order)
      returns:
        - key: users
          type: ListUsersResponse
          unwrap: true
          properties:
            - key: Data
              type: 'User[]'
              description: (list_users.data)
            - key: ListMetadata
              type: ListMetadata
              properties:
                - (Before)
                - (After)
        - (err)
  php:
    - key: listUsers
      patternBefore: userManagement->
      id: list_users
      url: /reference/authkit/user/list
      title: $userManagement->listUsers()
      parameters:
        - key: options
          type: object
          unwrap: true
          properties:
            - key: email
              optional: true
              type: string
              description: (list_users.email)
            - key: organizationId
              optional: true
              type: string
              description: (list_users.organization_id)
            - (limit)
            - (before)
            - (after)
            - (order)
      returns:
        - key: anonymous
          type: array
          unwrap: true
          properties:
            - (before)
            - (after)
            - key: data
              type: 'User[]'
              description: (list_users.data)
  python:
    - key: list_users
      patternBefore: user_management.
      id: list_users
      url: /reference/authkit/user/list
      title: user_management.list_users()
      parameters:
        - key: email
          optional: true
          type: str
          description: (list_users.email)
        - key: organization_id
          optional: true
          type: str
          description: (list_users.organization_id)
        - (after)
        - (before)
        - (limit)
        - (order)
      returns:
        - key: anonymous
          type: WorkOSListResource
          unwrap: true
          properties:
            - key: data
              type: 'list[User]'
              description: (list_users.data)
            - key: list_metadata
              type: ListMetadata
              properties:
                - (before)
                - (after)
  ruby:
    - key: list_users
      id: list_users
      url: /reference/authkit/user/list
      title: UserManagement.list_users()
      parameters:
        - key: email
          optional: true
          type: String
          description: (list_users.email)
        - key: organization_id
          optional: true
          type: String
          description: (list_users.organization_id)
        - (after)
        - (before)
        - (limit)
        - (order)
      returns:
        - key: anonymous
          type: Struct
          unwrap: true
          properties:
            - key: data
              type: 'Array[User]'
              description: (list_users.data)
            - key: list_metadata
              type: Hash
              properties:
                - (before)
                - (after)
  java:
    - key: listUsers
      id: list_users
      url: /reference/authkit/user/list
      title: userManagement.listUsers()
      parameters:
        - key: options
          type: ListUsersOptions
          optional: true
          unwrap: true
          properties:
            - key: email
              optional: true
              type: String
              description: (list_users.email)
            - key: organizationId
              optional: true
              type: String
              description: (list_users.organization_id)
            - (after)
            - (before)
            - (limit)
            - (order)
      returns:
        - key: anonymous
          type: Users
          unwrap: true
          properties:
            - key: data
              type: 'Array[User]'
              description: (list_users.data)
            - key: listMetadata
              type: ListMetadata
              properties:
                - (before)
                - (after)
originalPath: .tmp-workos-clone/packages/docs/content/reference/authkit/user/list.mdx
---

## List users

Get a list of all of your existing users matching the criteria specified.

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