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

# Get Availability

> Retrieves availability schedule for a specific artist



## OpenAPI

````yaml GET /availability/get-availability
openapi: 3.1.0
info:
  title: Tatu API
  description: API documentation for Tatu's booking and artist management system
  version: 1.0.0
servers:
  - url: http://localhost:3000/api
    description: Development server
security: []
paths:
  /availability/get-availability:
    get:
      summary: Get Availability
      description: Retrieves availability schedule for a specific artist
      parameters:
        - name: artistId
          in: query
          required: true
          schema:
            type: string
          description: The ID of the artist
      responses:
        '200':
          description: Availability retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Availability'
components:
  schemas:
    Availability:
      type: object
      required:
        - artistId
        - availabilityId
        - isActive
        - weeklySlots
        - dateRangeType
        - effectiveFrom
        - createdAt
        - updatedAt
      properties:
        artistId:
          type: string
          description: ID of the artist this availability belongs to
        availabilityId:
          type: string
          description: Unique identifier for this availability
        isActive:
          type: boolean
          description: Whether this availability is currently active
        weeklySlots:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/DaySlots'
          description: Weekly schedule with days as keys (e.g., 'Sunday', 'Monday')
        dateRangeType:
          $ref: '#/components/schemas/AvailabilityDateRangeTypeEnum'
          description: Type of date range for this availability
        effectiveFrom:
          type: number
          description: >-
            UTC timestamp in milliseconds when this availability becomes
            effective
        effectiveUntil:
          type: number
          description: Optional UTC timestamp in milliseconds when this availability ends
        rollingDays:
          type: string
          description: Optional number of days to roll over when dateRangeType is 'rolling'
        createdAt:
          type: number
          description: UTC timestamp in milliseconds when this availability was created
        updatedAt:
          type: number
          description: >-
            UTC timestamp in milliseconds when this availability was last
            updated
    DaySlots:
      type: object
      required:
        - timeSlots
      properties:
        timeSlots:
          type: array
          items:
            $ref: '#/components/schemas/TimeSlot'
          description: List of time slots for this day
    AvailabilityDateRangeTypeEnum:
      type: string
      enum:
        - indefinitely
        - specific
        - rolling
      description: Type of date range for availability
    TimeSlot:
      type: object
      required:
        - startTime
        - endTime
      properties:
        startTime:
          type: string
          format: date-time
          description: Start time of the slot
        endTime:
          type: string
          format: date-time
          description: End time of the slot

````