# List availabilities

Retrieves a paginated list of availability time blocks for a specific user.

Endpoint: GET /users/{user_id}/availabilities
Version: v1
Security: AuthToken

## Path parameters:

  - `user_id` (integer, required)
    The ID of the user.

## Query parameters:

  - `page` (integer)
    The page number to retrieve.

  - `per_page` (integer)
    The number of items to return per page.

## Response 200 fields (application/json):

  - `paging` (object)

  - `paging.per_page` (integer)
    The maximum number of items to show per response page.
    Example: 100

  - `paging.page` (integer)
    The current response page number.
    Example: 1

  - `paging.previous` (string,null)
    If you're on the first page, this value is null; otherwise the value is the path and query parameters to get the previous page of items.
    Example: "/api/v1/users?per_page=1000&page=1"

  - `paging.self` (string)
    The path and query parameters to get the current page of items.
    Example: "/api/v1/users?per_page=1000&page=2"

  - `paging.next` (string,null)
    If there are more items, this value is the path and query parameters to get the next page of items; otherwise, it's null.
    Example: "/api/v1/users?per_page=1000&page=3"

  - `paging.count` (integer,null)
    The total number of items in all the pages.

  - `data` (array)

  - `data.id` (integer, required)
    The unique identifier for the availability block.
    Example: 52

  - `data.user_id` (integer, required)
    The ID of the user this availability block belongs to.
    Example: 269

  - `data.day0` (number, required)
    Available hours on Sunday.

  - `data.day1` (number, required)
    Available hours on Monday.
    Example: 8

  - `data.day2` (number, required)
    Available hours on Tuesday.
    Example: 8

  - `data.day3` (number, required)
    Available hours on Wednesday.
    Example: 4

  - `data.day4` (number, required)
    Available hours on Thursday.
    Example: 8

  - `data.day5` (number, required)
    Available hours on Friday.
    Example: 8

  - `data.day6` (number, required)
    Available hours on Saturday.

  - `data.starts_at` (string,null, required)
    The effective start date for the availability block. Null implies the past.
    Example: "2017-01-30"

  - `data.ends_at` (string,null, required)
    The effective end date for the availability block. Null implies the future.
    Example: "2017-07-28"

  - `data.created_at` (string)
    The time of creation.
    Example: "2024-08-27T12:00:00Z"

  - `data.updated_at` (string)
    The time of the last update.
    Example: "2024-08-27T12:00:00Z"

## Response 404 fields (application/json):

  - `message` (string)
    Example: "not found"