> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usetokenless.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sessions

<div className="endpoint-signature"><span className="endpoint-method endpoint-method-get">GET</span><code>/v1/usage/sessions/list</code></div>


## OpenAPI

````yaml /openapi/usage.yaml get /v1/usage/sessions/list
openapi: 3.1.0
info:
  title: Tokenless Cost and Usage API
  version: 1.0.0
  description: |
    Account credit, routed-request cost, usage history, and session aggregate
    endpoints. Monetary amounts are integer USD nanos:
    1,000,000,000 nanos equals US $1.00.
servers:
  - url: https://api.usetokenless.com
security:
  - bearerAuth: []
paths:
  /v1/usage/sessions/list:
    get:
      summary: Sessions
      operationId: listUsageSessions
      parameters:
        - name: limit
          in: query
          description: Number of sessions. Defaults to 30; maximum 100.
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 30
      responses:
        '200':
          description: Recent session aggregates, newest activity first.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SessionListItem'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    SessionListItem:
      type: object
      required:
        - request_count
        - total_cost_nanos
        - latest_at
      properties:
        session_id:
          type:
            - string
            - 'null'
        request_count:
          type: integer
          format: int64
        total_cost_nanos:
          type: integer
          format: int64
        latest_at:
          type: string
          format: date-time
        session_source:
          type: string
  responses:
    Unauthorized:
      description: Missing or invalid authentication.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Tokenless API key, Clerk JWT, or tkl CLI session

````