---
descriptions:
  list_sessions:
    user_id: Sessions belonging to this user will be returned.
    data: 'Array of [sessions](/reference/authkit/session) ordered by creation time.'
reference:
  curl:
    - key: list_sessions
      id: list_sessions
      url: /reference/authkit/session/list
      title: '/user_management/users/:id/sessions'
      type: GET
      parameters:
        - (limit)
        - (before)
        - (after)
        - (order)
      returns:
        - key: anonymous
          type: object
          unwrap: true
          properties:
            - key: data
              type: array
              description: (list_sessions.data)
            - key: list_metadata
              type: object
              properties:
                - (before)
                - (after)
  js:
    - key: listSessions
      patternBefore: userManagement.
      id: list_sessions
      url: /reference/authkit/session/list
      title: userManagement.listSessions()
      parameters:
        - key: userId
          type: string
          description: (list_sessions.user_id)
        - key: options
          type: object
          optional: true
          unwrap: true
          properties:
            - (limit)
            - (before)
            - (after)
            - (order)
      returns:
        - key: anonymous
          type: object
          unwrap: true
          properties:
            - key: data
              type: 'Session[]'
              description: (list_sessions.data)
            - key: listMetadata
              type: object
              properties:
                - (before)
                - (after)
  python:
    - key: list_sessions
      patternBefore: user_management
      id: list_sessions
      url: /reference/authkit/session/list
      title: user_management.list_sessions()
      parameters:
        - key: user_id
          type: string
          description: (list_sessions.user_id)
        - (limit)
        - (before)
        - (after)
        - (order)
      returns:
        - key: anonymous
          type: WorkOSListResource
          unwrap: true
          properties:
            - key: data
              type: 'list[Session]'
              description: (list_sessions.data)
            - key: list_metadata
              type: 'list[ListMetadata]'
              properties:
                - (before)
                - (after)
            - key: list_args
              type: SessionsListFilters
              properties:
                - key: user_id
                  type: string
                  description: (list_sessions.user_id)
                - (before)
                - (after)
                - (limit)
                - (order)
originalPath: .tmp-workos-clone/packages/docs/content/reference/authkit/session/list.mdx
---

## List sessions

Get a list of all active sessions for a specific user.

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