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

# Get Availabilities

> List the availability schedules on your Novacal account, including their name, timezone, working days, and open hours.

## What this endpoint returns

An availability schedule holds the hours you are open for bookings. This endpoint returns every schedule on your account, newest first.

Each event type points to one schedule. The schedule marked `is_default` is the one new event types get.

## Reading the hours

`working_days` lists the weekdays the schedule is open on. `hours` gives the open periods for each of those weekdays, in the timezone of the schedule. A weekday with more than one period has a break between them.

```json theme={null}
{
  "timezone": "Europe/Belgrade",
  "working_days": ["monday", "tuesday"],
  "hours": {
    "monday": [{ "start": "09:00", "end": "17:00" }],
    "tuesday": [
      { "start": "09:00", "end": "12:00" },
      { "start": "14:00", "end": "17:00" }
    ]
  }
}
```

These are the rules, not the free times. To see when a person can actually book, which also counts existing events, use [Get Availability](/api-reference/v1/availability/get).


## OpenAPI

````yaml GET /v1/availabilities
openapi: 3.1.0
info:
  title: Events API
  description: Public API for managing event types
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.novacal.io
security:
  - bearerAuth: []
paths:
  /v1/availabilities:
    get:
      description: Returns the availability schedules of the authenticated user.
      responses:
        '200':
          description: Availabilities response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AvailabilitiesResponse'
components:
  schemas:
    AvailabilitiesResponse:
      type: object
      required:
        - success
        - data
      properties:
        success:
          description: Indicates whether the request was successful
          type: boolean
          example: true
        data:
          type: array
          items:
            $ref: '#/components/schemas/Availability'
    Availability:
      type: object
      properties:
        id:
          description: The unique identifier of the availability schedule
          type: integer
          example: 7
        name:
          description: The name of the schedule
          type: string
          example: Working hours
        timezone:
          description: IANA timezone the hours are expressed in
          type: string
          example: Europe/Belgrade
        is_default:
          description: Whether new event types get this schedule
          type: boolean
          example: true
        working_days:
          description: The weekdays the schedule is open on
          type: array
          items:
            type: string
            enum:
              - monday
              - tuesday
              - wednesday
              - thursday
              - friday
              - saturday
              - sunday
          example:
            - monday
            - tuesday
        hours:
          description: >-
            Open hours per weekday, in the schedule timezone. A weekday that is
            absent is closed.
          type: object
          additionalProperties:
            type: array
            items:
              $ref: '#/components/schemas/AvailabilityHours'
          example:
            monday:
              - start: '09:00'
                end: '17:00'
            tuesday:
              - start: '09:00'
                end: '12:00'
              - start: '14:00'
                end: '17:00'
        created_at:
          description: The date and time the schedule was created
          type: string
          format: date-time
        updated_at:
          description: The date and time the schedule was last changed
          type: string
          format: date-time
    AvailabilityHours:
      type: object
      properties:
        start:
          description: Opening time in HH:MM, in the schedule timezone
          type: string
          example: '09:00'
        end:
          description: Closing time in HH:MM, in the schedule timezone
          type: string
          example: '17:00'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````