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

# List visits

> Retrieve a list of visits



## OpenAPI

````yaml /api-reference/openapi.yaml get /visitors/visits
openapi: 3.0.3
info:
  title: Rntor API
  description: REST API for programmatic access to your coworking and space management data
  version: 1.0.0
  contact:
    email: support@rntor.com
    url: https://app.rntor.com
servers:
  - url: https://api.rntor.com/v1
    description: Production server
security:
  - bearerAuth: []
    clientId: []
tags:
  - name: Merchant
    description: Merchant operations
  - name: Bookings
    description: Booking management
  - name: Companies
    description: Company management
  - name: Resources
    description: Resource management
  - name: Locations
    description: Location management
  - name: Invoices
    description: Invoice and credit note management
  - name: Subscriptions
    description: Customer subscription management
  - name: Events
    description: Event management
  - name: Plans
    description: Membership plan management
  - name: Memberships
    description: Membership management
  - name: Benefits
    description: Benefits, categories, and applications
  - name: Contracts
    description: Contract management
  - name: Feed
    description: Feed posts, comments, and likes
  - name: Shop
    description: Shop orders, categories, and products
  - name: Members
    description: Member registrations
  - name: Tickets
    description: Support ticket management
  - name: Transactions
    description: Credit, day pass, and payment transactions
  - name: Visitors
    description: Visitor contacts, requests, and visits
paths:
  /visitors/visits:
    get:
      tags:
        - Visitors
      summary: List visits
      description: Retrieve a list of visits
      operationId: listVisits
      parameters:
        - $ref: '#/components/parameters/PageParam'
        - $ref: '#/components/parameters/PerPageParam'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Visit'
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                  meta:
                    $ref: '#/components/schemas/Meta'
              example:
                data:
                  - id: 3c90c3cc-0d44-4b50-8888-8dd25736052a
                    visitor_first_name: Jane
                    visitor_last_name: Smith
                    visitor_email: jane.smith@example.com
                    host_id: 4d91d4dd-1e55-5c61-9999-9ee36847163b
                    location_id: 5e02e5ee-2f66-6d72-0000-0ff47958274c
                    visit_date: '2024-01-15'
                    status: scheduled
                    created_at: '2024-01-14T10:00:00Z'
                    updated_at: '2024-01-14T10:00:00Z'
                pagination:
                  page: 1
                  per_page: 20
                  total: 75
                  total_pages: 4
                  has_more: true
                meta:
                  request_id: req_abc123def456
                  timestamp: '2024-01-15T10:30:00Z'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  parameters:
    PageParam:
      name: page
      in: query
      description: Page number
      schema:
        type: integer
        default: 1
        minimum: 1
    PerPageParam:
      name: per_page
      in: query
      description: Items per page
      schema:
        type: integer
        default: 20
        minimum: 1
        maximum: 100
  schemas:
    Visit:
      type: object
      properties:
        id:
          type: string
          format: uuid
          example: 3c90c3cc-0d44-4b50-8888-8dd25736052a
        visitor_first_name:
          type: string
          example: Jane
        visitor_last_name:
          type: string
          example: Smith
        visitor_email:
          type: string
          format: email
          example: jane.smith@example.com
        host_id:
          type: string
          format: uuid
        location_id:
          type: string
          format: uuid
        visit_date:
          type: string
          format: date
          example: '2024-01-15'
        check_in_time:
          type: string
          format: date-time
        check_out_time:
          type: string
          format: date-time
        status:
          type: string
          example: scheduled
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
    Pagination:
      type: object
      properties:
        page:
          type: integer
          example: 1
        per_page:
          type: integer
          example: 20
        total:
          type: integer
          example: 150
        total_pages:
          type: integer
          example: 8
        has_more:
          type: boolean
          example: true
    Meta:
      type: object
      properties:
        request_id:
          type: string
          example: req_abc123def456
        timestamp:
          type: string
          format: date-time
          example: '2024-01-15T10:30:00Z'
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              example: validation_error
            message:
              type: string
              example: The request body is missing required field 'email'
            details:
              type: object
              properties:
                field:
                  type: string
                  example: email
                reason:
                  type: string
                  example: required
        meta:
          type: object
          properties:
            request_id:
              type: string
              example: req_abc123def456
  responses:
    BadRequest:
      description: Bad Request - Validation error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: validation_error
              message: The request body is missing required field 'email'
              details:
                field: email
                reason: required
            meta:
              request_id: req_abc123def456
    Unauthorized:
      description: Unauthorized - Invalid or missing credentials
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: invalid_token
              message: The access token is invalid or expired
            meta:
              request_id: req_abc123def456
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Your API client secret
    clientId:
      type: apiKey
      in: header
      name: X-Client-ID
      description: Your API client ID

````