---
descriptions:
  session:
    self: 'The corresponding [session](/reference/authkit/session) object.'
    object: Distinguishes the session object.
    id: The unique ID of the session.
    user_id: The ID of the user this session belongs to.
    organization_id: The ID of the organization this session is associated with.
    status: The current status of the session.
    auth_method: The authentication method used to create this session.
    ip_address: The IP address from which the session was created.
    user_agent: The user agent string from the device that created the session.
    impersonator: >-
      Information about the impersonator if this session was created via
      impersonation.
    expires_at: The timestamp when the session expires.
    ended_at: The timestamp when the session ended.
    created_at: The timestamp when the session was created.
    updated_at: The timestamp when the session was last updated.
reference:
  curl:
    - url: /reference/authkit/session
      key: session
      id: session
      title: session
      properties:
        - key: object
          type: '"session"'
          description: (session.object)
        - key: id
          type: string
          description: (session.id)
        - key: user_id
          type: string
          description: (session.user_id)
        - key: organization_id
          optional: true
          type: string
          description: (session.organization_id)
        - key: status
          type: string
          description: (session.status)
        - key: auth_method
          type: string
          description: (session.auth_method)
        - key: ip_address
          optional: true
          type: string
          description: (session.ip_address)
        - key: user_agent
          optional: true
          type: string
          description: (session.user_agent)
        - key: impersonator
          optional: true
          type: object
          description: (session.impersonator)
        - key: expires_at
          type: string
          description: (session.expires_at)
        - key: ended_at
          optional: true
          type: string
          description: (session.ended_at)
        - key: created_at
          type: string
          description: (session.created_at)
        - key: updated_at
          type: string
          description: (session.updated_at)
  js:
    - url: /reference/authkit/session
      key: Session
      id: session
      title: interface Session
      properties:
        - key: object
          type: '"session"'
          description: (session.object)
        - key: id
          type: string
          description: (session.id)
        - key: userId
          type: string
          description: (session.user_id)
        - key: organizationId
          optional: true
          type: string
          description: (session.organization_id)
        - key: status
          type: string
          description: (session.status)
        - key: authMethod
          type: string
          description: (session.auth_method)
        - key: ipAddress
          optional: true
          type: string
          description: (session.ip_address)
        - key: userAgent
          optional: true
          type: string
          description: (session.user_agent)
        - key: impersonator
          optional: true
          type: object
          description: (session.impersonator)
        - key: expiresAt
          type: string
          description: (session.expires_at)
        - key: endedAt
          optional: true
          type: string
          description: (session.ended_at)
        - key: createdAt
          type: string
          description: (session.created_at)
        - key: updatedAt
          type: string
          description: (session.updated_at)
originalPath: .tmp-workos-clone/packages/docs/content/reference/authkit/session/index.mdx
---

# Session

Represents an authenticated user's connection to your application. A session is created when a user signs in through AuthKit and contains information about the authentication method, device details, and session status.

<CodeBlock title="Session" referenceId="session" file="session" />