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

# List User Tours

> Returns all tours the current user has interacted with, ordered by completion timestamp ascending.



## OpenAPI

````yaml /api-reference/openapi/Evo-Auth-Service/user_tours.yaml get /api/v1/user_tours
openapi: 3.0.4
info:
  title: Evolution Foundation - Auth Service - User Tours
  description: |
    Tracks the completion state of in-app onboarding tours per user.
    Each tour is identified by a free-form `tour_key` chosen by the frontend.

    Available starting `v1.0.0-rc3`.
  version: 1.0.0
servers:
  - url: https://app.evochat.ai
  - url: http://localhost:3001
security: []
paths:
  /api/v1/user_tours:
    get:
      summary: List User Tours
      description: >-
        Returns all tours the current user has interacted with, ordered by
        completion timestamp ascending.
      operationId: list-user-tours
      responses:
        '200':
          description: Tours retrieved
          content:
            application/json:
              schema:
                type: object
                required:
                  - success
                  - data
                  - message
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/UserTour'
                  message:
                    type: string
        '401':
          $ref: '#/components/responses/Unauthorized'
      security:
        - bearerAuth: []
components:
  schemas:
    UserTour:
      type: object
      properties:
        id:
          type: string
          format: uuid
        tour_key:
          type: string
          example: agents-walkthrough
        completed_at:
          type: string
          format: date-time
        status:
          type: string
          enum:
            - completed
            - skipped
            - in_progress
          example: completed
  responses:
    Unauthorized:
      description: Missing or invalid bearer token
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                example: false
              message:
                type: string
                example: Unauthorized
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.