Skip to content
/User Availabilities

User Availabilities

Operations

List user availabilities

Request

Returns availability schedules. Use userId to filter results for a specific user; omit it to return all accessible schedules. Each item includes schedule metadata, weekday slots, and linked event IDs.

Security
oauth2(Required scopes: availabilities:read) or bearerAuth(Required scopes: availabilities:read)
Query
userIdinteger, ( 0 .. 2147483647 ]

Optional user ID to return availabilities for a specific user.

curl -i -X GET \
  'https://developer.iclosed.io/_mock/openapi/v1/openapi/v1/userAvailabilities?userId=1' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Availability schedules matching the request

Bodyapplication/json
dataArray of objectsrequired

List of availability schedules matching the request filter.

Response
{
  "data": [
    {
      "id": 1,
      "name": "test",
      "userId": 101,
      "timeZone": "America/Los_Angeles",
      "isDefault": false,
      "userAvailabilityDays": [
        {
          "id": 1,
          "name": "monday",
          "active": true,
          "timings": [
            {
              "startTime": "09:00",
              "endTime": "17:30"
            },
            {
              "startTime": "17:15",
              "endTime": "17:45"
            },
            {
              "startTime": "18:00",
              "endTime": "18:30"
            },
            {
              "startTime": "18:45",
              "endTime": "19:15"
            }
          ]
        },
        {
          "id": 2,
          "name": "tuesday",
          "active": true,
          "timings": [
            {
              "startTime": "09:00",
              "endTime": "17:00"
            },
            {
              "startTime": "17:15",
              "endTime": "17:45"
            },
            {
              "startTime": "18:00",
              "endTime": "18:30"
            },
            {
              "startTime": "18:45",
              "endTime": "19:15"
            },
            {
              "startTime": "19:30",
              "endTime": "20:00"
            }
          ]
        },
        {
          "id": 3,
          "name": "wednesday",
          "active": true,
          "timings": [
            {
              "startTime": "09:00",
              "endTime": "17:00"
            },
            {
              "startTime": "17:15",
              "endTime": "17:45"
            },
            {
              "startTime": "18:00",
              "endTime": "18:30"
            },
            {
              "startTime": "18:45",
              "endTime": "19:15"
            },
            {
              "startTime": "19:30",
              "endTime": "20:00"
            }
          ]
        },
        {
          "id": 4,
          "name": "thursday",
          "active": true,
          "timings": [
            {
              "startTime": "09:00",
              "endTime": "17:00"
            },
            {
              "startTime": "17:15",
              "endTime": "17:45"
            },
            {
              "startTime": "18:00",
              "endTime": "18:30"
            },
            {
              "startTime": "18:45",
              "endTime": "19:15"
            },
            {
              "startTime": "19:30",
              "endTime": "20:00"
            },
            {
              "startTime": "20:15",
              "endTime": "20:45"
            },
            {
              "startTime": "21:00",
              "endTime": "21:30"
            },
            {
              "startTime": "21:45",
              "endTime": "22:15"
            }
          ]
        },
        {
          "id": 5,
          "name": "friday",
          "active": true,
          "timings": [
            {
              "startTime": "09:00",
              "endTime": "17:00"
            },
            {
              "startTime": "17:15",
              "endTime": "17:45"
            },
            {
              "startTime": "18:00",
              "endTime": "18:30"
            },
            {
              "startTime": "18:45",
              "endTime": "19:15"
            },
            {
              "startTime": "19:30",
              "endTime": "20:00"
            },
            {
              "startTime": "20:15",
              "endTime": "20:45"
            }
          ]
        },
        {
          "id": 6,
          "name": "saturday",
          "active": true,
          "timings": [
            {
              "startTime": "09:00",
              "endTime": "17:00"
            },
            {
              "startTime": "17:15",
              "endTime": "17:45"
            },
            {
              "startTime": "18:00",
              "endTime": "18:30"
            },
            {
              "startTime": "18:45",
              "endTime": "19:15"
            },
            {
              "startTime": "19:30",
              "endTime": "20:00"
            },
            {
              "startTime": "20:15",
              "endTime": "20:45"
            },
            {
              "startTime": "21:00",
              "endTime": "21:30"
            },
            {
              "startTime": "21:45",
              "endTime": "22:15"
            },
            {
              "startTime": "22:30",
              "endTime": "23:00"
            },
            {
              "startTime": "23:15",
              "endTime": "23:45"
            }
          ]
        },
        {
          "id": 7,
          "name": "sunday",
          "active": true,
          "timings": [
            {
              "startTime": "09:00",
              "endTime": "17:00"
            },
            {
              "startTime": "17:15",
              "endTime": "17:45"
            },
            {
              "startTime": "18:00",
              "endTime": "18:30"
            },
            {
              "startTime": "18:45",
              "endTime": "19:15"
            }
          ]
        }
      ],
      "eventId": [
        1,
        2,
        10
      ]
    },
    {
      "id": 2,
      "name": "Working Hours",
      "userId": 101,
      "timeZone": "America/New_York",
      "isDefault": true,
      "userAvailabilityDays": [
        {
          "id": 1,
          "name": "monday",
          "active": true,
          "timings": [
            {
              "startTime": "00:00",
              "endTime": "23:40"
            }
          ]
        },
        {
          "id": 2,
          "name": "tuesday",
          "active": true,
          "timings": [
            {
              "startTime": "00:00",
              "endTime": "23:45"
            }
          ]
        },
        {
          "id": 3,
          "name": "wednesday",
          "active": true,
          "timings": [
            {
              "startTime": "00:00",
              "endTime": "23:45"
            }
          ]
        },
        {
          "id": 4,
          "name": "thursday",
          "active": true,
          "timings": [
            {
              "startTime": "00:00",
              "endTime": "23:45"
            }
          ]
        },
        {
          "id": 5,
          "name": "friday",
          "active": true,
          "timings": [
            {
              "startTime": "00:00",
              "endTime": "23:45"
            }
          ]
        },
        {
          "id": 6,
          "name": "saturday",
          "active": true,
          "timings": [
            {
              "startTime": "00:00",
              "endTime": "23:45"
            }
          ]
        },
        {
          "id": 7,
          "name": "sunday",
          "active": true,
          "timings": [
            {
              "startTime": "00:00",
              "endTime": "23:45"
            }
          ]
        }
      ],
      "eventId": [
        1,
        2,
        3
      ]
    }
  ]
}