Api::Unified::Clubs::LocationsController

    This controller provides access to locations available to the current user.

GET /api/unified/clubs/locations

      Fetches all the locations visible to the client.

{
// Contains filters to limit response by specific criteria
// Can be null "unified_filters": {
// Include only locations belonging to a specific parent location
// Can be null "parent_id": 657, // Include only locations belonging to a specific Region
// Can be null "region_id": 471, // Include only locations belonging to a specific Club
// Can be null "club_id": 825, // Include only hidden locations
// Can be null "hidden": true, // A string to peform a full-text search against
// Can be null "fulltext": "Some string", // An id of client_id for filter by his memberships locations
// Can be null "memberships_client_id": 23, // Tag id to filter locations by
// Can be null "tag_ids": [ "An", "Array", "Of", "Strings/Integers" ], // Tag ids and strings to peform a full-text search against to filter locations by
// Can be null "tags_fulltext": [ "An", "Array", "Of", "Strings/Integers" ] } ,
// Pagination settings
// Can be null "limit": {
// The number of items to skip (=start from)
// Cannot be null "start": 669, // The number of items to include into response
// Cannot be null "count": 48 } ,
// Sorting settings
// Can be null "unified_sorting": {
// Sort by name, ascending if true
// Can be null "name": true }
}

{
// The list of location models matching filters and pagination settings
// Cannot be null "locations": [ Location::Index ], // Total number of items
// Cannot be null "count": 29 }

GET /api/unified/clubs/locations/:id

      Shows the location entity

The :id placeholder in the URL has to be replaced with the identifier of the entity to be manipulated.

{
// Internal ID of the location
// Cannot be null "id": 748 }

{
// A location entity
// Can be null "location": Location::Show }

Api::Unified::SessionsController

  This controller provides a set of APIs for signing in, signing out, resetting the password and so on.

POST /api/unified/sessions/auth

      Attemps to authenticate the user using one of the implemented strategies.
      Available options are:
      * fisikal_token is used internally to cross-authenticate the user between Fisikal subsystems. Not for external use.
      * email and password are used to authenticate the user via providing Fisikal credentials.
      * dll hash is used to authenticate the user using David Lloyd oAuth data.

{
// Fisikal authentication token
// Can be null "fisikal_token": "Some string", // FKL Club ID of the user to log in (used when there are multiple users in the account)
// Can be null "club_id": 119, // FKL ID of the user to log in (used when there are multiple users in the account)
// Can be null "id": 209, // A hash used for processing DLL oAuth responses
// Can be null "dll": {
// oAuth code returned by DLL
// Cannot be null "code": "Some string", // oAuth token returned by DLL
// Cannot be null "token": "Some string", // Redirect URL used during authentication
// Cannot be null "redirect_url": "Some string" } ,
// A hash used for processing FFUK auth
// Can be null "ffuk": {
// FFUK email
// Cannot be null "email": "Some string", // FFUK password
// Cannot be null "password": "Some string", // FFUK identifier
// Cannot be null "identifier": "Some string" } ,
// A hash used for processing EGYM auth
// Can be null "egym": {
// EGYM Identity token (JWT)
// Cannot be null "token": "Some string", // EGYM Custom token (JWT). Used when login with EGYM
// Cannot be null "custom_token": "Some string" } ,
// A hash used for processing MGF auth responses
// Can be null "mgf": {
// auth token returned by DLL
// Cannot be null "token": "Some string" } ,
// Authenticate with PerfectGym
// Can be null "perfect_gym": {
// PerfectGym member login
// Cannot be null "login": "Some string", // PerfectGym member password
// Cannot be null "password": "Some string" } ,
// E-mail of the user
// Can be null "email": "Some string", // Password to authenticate with
// Can be null "password": "Some string", // Roles accepted for signing in
// Can be null "roles": [ "An", "Array", "Of", "Strings/Integers" ] }

{
// The user model which represents the user currently signed in
// Can be null "user": User::Auth, // The club of the current user
// Can be null "club": Club::Auth, // Identity entry with token information (if needed within the app)
// Can be null "identity": Identity::Auth, // The list of alternative accounts this user can switch to
// Can be null "users": [ User::Auth ] }

POST /api/unified/sessions/sign_up

      Attempts to create user's account within the current club.

{
// A hash containing user's attributes
// Cannot be null "user": {
// The name of the user to be used
// Cannot be null "name": "Some string", // The e-mail of the user to be used
// Cannot be null "email": "Some string", // The password which user wants to be used for his account
// Can be null "password": "Some string", // The club which users wants to be in
// Can be null "club_id": "Some string", // The home location which user wants to be used for his account
// Can be null "home_location_id": "Some string", // The title of the user to be used
// Can be null "title": "Some string", // The mobile number which user wants to be used
// Can be null "mobile_no": "Some string", // The sex of the user to be used
// Can be null "sex": "Some string", // The date of birth of the user to be used
// Can be null "dob": "Some string" }
}

{
// A hash containing user's attributes
// Cannot be null "user": {
// A set of errors occurred during creating a user's account
// Cannot be null "errors": [ Error::Index ] }
}

PUT /api/unified/sessions/restore_password

      Initiates password restore flow for the user with the email supplied.

{
// The object to identify the user
// Cannot be null "user": {
// E-mail address of the user
// Cannot be null "email": "Some string" }
}

DELETE /api/unified/sessions

    Clears all session data associated with a user, along with a spoof stack, if present.

Api::Unified::VersionsController

    This controller is used to obtain access to applications' versions.

GET /api/unified/versions/check

      Checks which versions of the app are configured on the backend and replies with the most
      recent one, along with a URL to that version, so that an app can suggest upgrading to the user.

{
// The identifier of the application to fetch the latest version for
// Cannot be null "app": "Some string", // The name of the platform of the app
// Allowed values are: "ios" and "android"
// Cannot be null "platform": "Some string" }

{
// Version string in MAJOR.MINOR.PATCH format
// Cannot be null "version": "Some string", // The URL to the page where this specific version is available for download. Can be either an App Store / Google Play URL, or a Fisikal application download page
// Can be null "url": "Some string" }

Api::Unified::Users::TrainersController

    This controller provides access to trainers APIs.

GET /api/unified/users/trainers/detailed

      Fetches all the trainers visible to the current user, allowing paging through them as well
      as filtering by multiple fields.

{
// Contains filters to limit response by specific criteria
// Can be null "unified_filters": {
// An arbitrary parameter limiting the collection to 1 trainer with the specified id
// Can be null "id": "Some string", // An arbitrary string to perform full-text search against
// Can be null "fulltext": "Some string", // Gender of the trainer
// Can be null "sex": true, // Boolean parameter to flag if not to show current user
// Can be null "others": "Some string", // Boolean parameter to flag if visible or hidden trainers to be shown
// Can be null "disabled": "Some string", // A list of group ids to show the clients from
// Can be null "group_ids": "Some string", // A list of locations ids to show the clients from
// Can be null "location_ids": "Some string", // Id of the service category that the trainer is assocated with
// Can be null "service_category_id": "Some string", // Returns trainers with the specified status: active, inactive, frozen
// Can be null "status": 320, // Include only trainer belonging to the SDH with id passed
// Can be null "service_working_time_id": 664, // Returns trainers associated to the selected service
// Can be null "service_id": 849, // Returns trainers who provides personal or group services
// Can be null "individual_trainers": true, // Returns trainers who share their schedule
// Can be null "share_schedule": true, // Returns trainers with the specified type
// Allowed values are: "Users::Trainers::Employed" and "Users::Trainers::SelfEmployed"
// Can be null "type": [ "An", "Array", "Of", "Strings/Integers" ], // Array of Tag IDs or an arbitrary string to perform full-text search against
// Can be null "tag_ids": [ "An", "Array", "Of", "Strings/Integers" ], // Array of Tag IDs or an arbitrary string to perform full-text search against both tag names and trainers
// Can be null "tags_fulltext": [ "An", "Array", "Of", "Strings/Integers" ], // Contains filters for coaches based on the relationships they have
// Can be null "relationship": {
// Minimum strength of relationship
// Can be null "min_strength": 189, // Ids of clients, relationships with whom will be analysed
// Can be null "client_ids": [ "An", "Array", "Of", "Strings/Integers" ], // Array of relationship types
// Allowed values are: "has_package_with", "has_booking_with", "has_assessment_with", "has_workout_from", "is_allocated_to", and "has_active_package_with"
// Can be null "type": [ "An", "Array", "Of", "Strings/Integers" ] }
} ,
// Sorting settings
// Can be null "unified_sorting": {
// Sort by name, ascending if true
// Can be null "name": true } ,
// Pagination settings
// Can be null "limit": {
// The number of items to skip (=start from)
// Cannot be null "start": 1, // The number of items to include into response
// Cannot be null "count": 100 }
}

{
// The detailed collection of trainers matching criteria and pagination settings
// Cannot be null "trainers": [ Trainer::Detailed ], // Total number of items
// Cannot be null "count": 62 }

GET /api/unified/users/trainers

      Fetches all the trainers visible to the current user, allowing paging through them as well
      as filtering by multiple fields.

{
// Contains filters to limit response by specific criteria
// Can be null "unified_filters": {
// An arbitrary parameter limiting the collection to 1 trainer with the specified id
// Can be null "id": "Some string", // An arbitrary string to perform full-text search against
// Can be null "fulltext": "Some string", // Gender of the trainer
// Can be null "sex": true, // Boolean parameter to flag if not to show current user
// Can be null "others": "Some string", // Boolean parameter to flag if visible or hidden trainers to be shown
// Can be null "disabled": "Some string", // A list of group ids to show the clients from
// Can be null "group_ids": "Some string", // A list of locations ids to show the clients from
// Can be null "location_ids": "Some string", // Id of the service category that the trainer is assocated with
// Can be null "service_category_id": "Some string", // Returns trainers with the specified status: active, inactive, frozen
// Can be null "status": 339, // Include only trainer belonging to the SDH with id passed
// Can be null "service_working_time_id": 303, // Returns trainers associated to the selected service
// Can be null "service_id": 375, // Returns trainers who provides personal or group services
// Can be null "individual_trainers": true, // Returns trainers who share their schedule
// Can be null "share_schedule": true, // Returns trainers with the specified type
// Allowed values are: "Users::Trainers::Employed" and "Users::Trainers::SelfEmployed"
// Can be null "type": [ "An", "Array", "Of", "Strings/Integers" ], // Array of Tag IDs or an arbitrary string to perform full-text search against
// Can be null "tag_ids": [ "An", "Array", "Of", "Strings/Integers" ], // Array of Tag IDs or an arbitrary string to perform full-text search against both tag names and trainers
// Can be null "tags_fulltext": [ "An", "Array", "Of", "Strings/Integers" ], // Contains filters for coaches based on the relationships they have
// Can be null "relationship": {
// Minimum strength of relationship
// Can be null "min_strength": 464, // Ids of clients, relationships with whom will be analysed
// Can be null "client_ids": [ "An", "Array", "Of", "Strings/Integers" ], // Array of relationship types
// Allowed values are: "has_package_with", "has_booking_with", "has_assessment_with", "has_workout_from", "is_allocated_to", and "has_active_package_with"
// Can be null "type": [ "An", "Array", "Of", "Strings/Integers" ] }
} ,
// Sorting settings
// Can be null "unified_sorting": {
// Sort by name, ascending if true
// Can be null "name": true } ,
// Pagination settings
// Can be null "limit": {
// The number of items to skip (=start from)
// Cannot be null "start": 887, // The number of items to include into response
// Cannot be null "count": 569 }
}

{
// The collection of trainers matching criteria and pagination settings
// Cannot be null "trainers": [ Trainer::Index ], // Total number of items
// Cannot be null "count": 497 }

GET /api/unified/users/trainers/:id

      Fetches specific trainer's profile.

The :id placeholder in the URL has to be replaced with the identifier of the entity to be manipulated.

{
// Requested trainer's profile
// Cannot be null "trainer": Trainer::Show }

Api::Unified::Services::ServicesController

    This controller provides access to services: models encapsulating the information about fitness classes in terms of duration, pricing etc.

GET /api/unified/services/services/colors

      Fetches all the service colors visible to the current user, allowing paging through them as well
      as filtering by multiple fields.

{
// Contains filters to limit response by specific criteria
// Can be null "unified_filters": {
// Returns a collection of the specified service by id
// Can be null "id": "Some string", // An arbitrary string to perform full-text search against
// Can be null "fulltext": "Some string", // Returns a collection of active / hidden services as specified
// Can be null "disabled": "Some string", // Returns a collection from the specified location
// Can be null "location_id": "Some string", // Returns a collection for the specified trainer
// Can be null "trainer_id": "Some string", // Returns a collection with / without the client_rates
// Can be null "client_rates": "Some string", // Returns a collection for the specified service category id
// Can be null "service_category_id": "Some string", // Include only services belonging to the SDH with id passed
// Can be null "service_working_time_id": 771, // Returns a collection for the specified activity category id
// Can be null "activity_category_id": "Some string", // Returns a collection for the specified service title id
// Can be null "service_title_id": "Some string", // Array of Tag IDs or an arbitrary string to perform full-text search against
// Can be null "tag_ids": [ "An", "Array", "Of", "Strings/Integers" ], // Tag id to filter services by (grouped inside tags categories])
// Can be null "tags_grouped_by_categories": [ "An", "Array", "Of", "Strings/Integers" ] } ,
// Sorting settings
// Can be null "unified_sorting": {
// Sort by service_title, ascending if true
// Can be null "service_title": true } ,
// Pagination settings
// Can be null "limit": {
// The number of items to skip (=start from)
// Cannot be null "start": 786, // The number of items to include into response
// Cannot be null "count": 423 }
}

{
// The list of service models matching filters and pagination settings
// Cannot be null "colors": [ Service::Colors ], // Total number of items
// Cannot be null "count": 764 }

GET /api/unified/services/services

      Fetches all the services visible to the client, allowing paging through them as well
      as filtering by multiple fields.

{
// Contains filters to limit response by specific criteria
// Can be null "unified_filters": {
// Include only services belonging to the activity category with id passed
// Can be null "activity_category_id": 216, // Include only services provided by a specific trainer
// Can be null "trainer_id": 966, // Include only services provided within a specific location
// Can be null "location_id": 93, // Include only services belonging to the service category with id passed
// Can be null "service_category_id": 759, // Include only services belonging to the SDH with id passed
// Can be null "service_working_time_id": 276, // A string to peform a full-text search against
// Can be null "fulltext": "Some string", // Include only entities marked by current user as favourite
// Can be null "starred": true, // Tag id to filter services by
// Can be null "tag_ids": [ "An", "Array", "Of", "Strings/Integers" ], // Tag id to filter services by (grouped inside tags categories])
// Can be null "tags_grouped_by_categories": [ "An", "Array", "Of", "Strings/Integers" ], // Tag ids and strings to peform a full-text search against to filter services by
// Can be null "tags_fulltext": [ "An", "Array", "Of", "Strings/Integers" ] } ,
// Sorting settings
// Can be null "unified_sorting": {
// Sort by name, ascending if true
// Can be null "name": true } ,
// Pagination settings
// Can be null "limit": {
// The number of items to skip (=start from)
// Cannot be null "start": 4, // The number of items to include into response
// Cannot be null "count": 225 }
}

{
// The list of service models matching filters and pagination settings
// Cannot be null "services": [ Service::Index ], // Total number of items
// Cannot be null "count": 735 }

GET /api/unified/services/services/:id

      Fetches a specific service to be presented to the client.

The :id placeholder in the URL has to be replaced with the identifier of the entity to be manipulated.

{
// Internal ID of the service
// Can be null "id": 494 }

{
// An extended version of the service model
// Can be null "service": Service::Show }

Api::Unified::Services::ActivityCategoriesController

    This controller provides access to activity categories, which are used to group services within a club.

GET /api/unified/services/activity_categories

      Fetches all the activity categories visible to the client, allowing paging through them as well
      as filtering by multiple fields.

{
// Contains filters to limit response by specific criteria
// Can be null "unified_filters": {
// An arbitrary string to perform full-text search against
// Can be null "fulltext": "Some string", // Whether to return activity categories with individual services only
// Can be null "single": true, // An id of service category to limit activity categories to
// Can be null "service_category_id": 168, // Array of Tag IDs or an arbitrary string to perform full-text search against
// Can be null "tag_ids": [ "An", "Array", "Of", "Strings/Integers" ], // Tag ids and strings to peform a full-text search against
// Can be null "tags_fulltext": [ "An", "Array", "Of", "Strings/Integers" ] } ,
// Sorting settings
// Can be null "unified_sorting": {
// Sort by name, ascending if true
// Can be null "name": true } ,
// Pagination settings
// Can be null "limit": {
// The number of items to skip (=start from)
// Cannot be null "start": 452, // The number of items to include into response
// Cannot be null "count": 407 }
}

{
// The collection of activity categories matching criteria and pagination settings
// Cannot be null "activity_categories": [ ActivityCategory::Index ], // Total number of items
// Cannot be null "count": 607 }

Api::Unified::Services::ServiceCategoriesController

    This controller provides access to service categories, which are used to group services within a club.

GET /api/unified/services/service_categories

      Fetches all the service categories available to the client.

{
// Contains filters to limit response by specific criteria
// Can be null "unified_filters": {
// The name to filter service categories by
// Can be null "name": "Some string", // Filter by show_in_member_app field
// Can be null "show_in_member_app": true } ,
// Sorting settings
// Can be null "unified_sorting": {
// Sort by name, ascending if true
// Can be null "name": true } ,
// Pagination settings
// Can be null "limit": {
// The number of items to skip (=start from)
// Cannot be null "start": 141, // The number of items to include into response
// Cannot be null "count": 871 }
}

{
// The list of service category models matching filters and pagination settings
// Cannot be null "service_categories": [ ServiceCategory::Index ], // Total number of items
// Cannot be null "count": 568 }

Api::Unified::Services::ServicePackagesController

    This controller provides access to service packages: models incapsulating multiple services to assign / purchase bulks at once.

GET /api/unified/services/service_packages

      Fetches all the service packages visible to the current user, allowing paging through them as well
      as filtering by multiple fields.

{
// Returns a collection of the specified club
// Cannot be null "club_id": 404, // Contains filters to limit response by specific criteria
// Can be null "unified_filters": {
// Returns a collection of the specified service package by id
// Can be null "id": "Some string", // Returns a collection from the specified location
// Can be null "location_id": "Some string" }
}

{
// The collection of service packages matching criteria and pagination settings
// Cannot be null "service_packages": [ ServicePackage::Index ], // Total number of items
// Cannot be null "count": 437 }

GET /api/unified/services/service_packages/:id

      Fetches the service package visible to a guest

The :id placeholder in the URL has to be replaced with the identifier of the entity to be manipulated.

{
// ID of the Service Package
// Cannot be null "id": 131, // Optional Location ID to get custom prices specific to Sales Location
// Can be null "location_id": 179 }

{
// An extended version of the location entity
// Can be null "service_package": ServicePackage::Show }

Api::Unified::Schedule::ServiceWorkingTimesController

    This controller provides API endpoints for managing Service Delivery Hours (SDH) entities.

GET /api/unified/schedule/service_working_times/lookup

      Creates a new service working time entity.

{
// Contains filters to limit response by specific criteria
// Can be null "unified_filters": {
// Id of the occurrence to return
// Can be null "id": "Some string", // Title of the entity
// Can be null "fulltext": "Some string", // A status to filter by
// Can be null "disabled": "Some string", // Only include SDH entities that are editable by current user
// Can be null "editable": true } ,
// Sorting settings
// Can be null "unified_sorting": {
// Sort by title, ascending if true
// Can be null "title": true } ,
// Pagination settings
// Can be null "limit": {
// The number of items to skip (=start from)
// Cannot be null "start": 320, // The number of items to include into response
// Cannot be null "count": 351 }
}

{
// The collection of service working times matching criteria and pagination settings
// Cannot be null "service_working_times": [ ServiceWorkingTime::Lookup ], // Total number of items
// Cannot be null "count": 202 }

GET /api/unified/schedule/service_working_times

      Fetches all available service working time entries.

{
// Contains filters to limit response by specific criteria
// Can be null "unified_filters": {
// Id of the occurrence to return
// Can be null "id": "Some string", // Title of the entity
// Can be null "fulltext": "Some string", // A status to filter by
// Can be null "disabled": true, // Only include SDH entities that are editable by current user
// Can be null "editable": true, // Standard flag of SDH to filter by
// Can be null "standard": true } ,
// Sorting settings
// Can be null "unified_sorting": {
// Sort by title, ascending if true
// Can be null "title": true } ,
// Pagination settings
// Can be null "limit": {
// The number of items to skip (=start from)
// Cannot be null "start": 516, // The number of items to include into response
// Cannot be null "count": 388 }
}

{
// The collection of service working times matching criteria and pagination settings
// Cannot be null "service_working_times": [ ServiceWorkingTime::Index ], // Total number of items
// Cannot be null "count": 905 }

Api::Unified::Schedule::WorkingTimesController

    This controller provides API endpoints for managing working time entities.

GET /api/unified/schedule/working_times

      Fetches all the working hours visible to the current club, allowing filtering by multiple fields.

{
// Contains filters to limit response by specific criteria
// Can be null "unified_filters": {
// An ID of the user to filter by
// Can be null "user_id": "Some string", // An ID of the user to filter by
// Can be null "trainer_id": "Some string", // An Array of trainers ID to filter by
// Can be null "trainer_ids": [ "An", "Array", "Of", "Strings/Integers" ], // A group_id of user to filter by
// Can be null "trainer_group_id": "Some string", // Show working times after this datetime
// Can be null "since": "2026-06-16T11:55:07Z", // Show working times before this datetime
// Can be null "till": "2026-06-16T11:55:07Z", // An ID of the location to filter by
// Can be null "location_id": "Some string", // An array of locations ID to filter by
// Can be null "blocked_location_id": [ "An", "Array", "Of", "Strings/Integers" ] }
}

{
// The collection of working times matching criteria
// Cannot be null "working_times": [ WorkingTime::Index ], // Total number of items
// Cannot be null "count": 268 }

Api::Unified::Schedule::OccurrencesController

    This controller is used to interact with schedule's entries, as well as provides APIs for enrolling into specific appointments.

GET /api/unified/schedule/occurrences

      Fetches all occurrences visible to the current user, allowing paging through them as well
      as filtering by multiple fields.

{
// Contains filters to limit response by specific criteria
// Can be null "unified_filters": {
// Returns occurrences since specified date
// Can be null "since": "2026-06-16T11:55:07Z", // Returns occurrences till specified date
// Can be null "till": "2026-06-16T11:55:07Z", // Returns occurrences for the specified location
// Can be null "location_id": 451, // Returns occurrences for the specified sub location
// Can be null "sub_location_id": 134, // Returns occurrences for the specified service activity category id
// Can be null "activity_category_id": 853, // Returns occurrences for the specified service category
// Can be null "service_category_id": 852, // Returns occurrences for the specified service
// Can be null "service_id": 639 } ,
// Sorting settings
// Can be null "unified_sorting": {
// Sort by id, ascending if true
// Can be null "id": true, // Sort by occurs_at, ascending if true
// Can be null "occurs_at": true } ,
// Pagination settings
// Can be null "limit": {
// The number of items to skip (=start from)
// Cannot be null "start": 977, // The number of items to include into response
// Cannot be null "count": 988 }
}

{
// The collection of occurrences matching criteria and pagination settings
// Cannot be null "occurrences": [ Occurrence::Index ], // Total number of items
// Cannot be null "count": 495 }

Location::Index

        This entity represents location record of a club.

{
// Persistent identifier of the entity
// Cannot be null "id": 620, // Id of the parent location, if this is sublocation
// Can be null "parent_id": 424, // Whether this location is hidden
// Cannot be null "hidden": true, // The Region ID of Location
// Can be null "region_id": 124, // The ALT ID of Location
// Can be null "alt_id": 328, // Full name of the location
// Cannot be null "name": "Some string", // Short code of the location
// Cannot be null "short_code": "Some string", // Number of the location
// Can be null "number": 816, // Latitude of the location
// Can be null "latitude": 41.2, // Longitude of the location
// Can be null "longitude": 37.6, // Whether this location directory is hidden
// Cannot be null "directory_is_enabled": true, // Name of the parent location, if available
// Can be null "parent_name": "Some string", // Directory model
// Can be null "directory": Directory::Show }

Directory::Show

        This entity represents location record of a directory(location).

{
// Persistent identifier of the entity
// Cannot be null "id": 970, // Identifier of the directory location
// Cannot be null "location_id": 556, // Вescription of the location directory
// Cannot be null "description": "Some string", // Main image url of the location directory
// Cannot be null "image_url": "Some string", // Address of the location directory
// Can be null "address": "Some string", // Postcode of the location directory
// Can be null "postcode": "Some string", // Phone number of the location directory
// Can be null "phone_no": "Some string", // Cover images URLS of the location directory
// Can be null "cover_image_urls": [ "An", "Array", "Of", "Strings/Integers" ], // Location name
// Can be null "name": "Some string", // Schedule pdf url
// Can be null "schedule_pdf_url": "Some string", // Shows the link to the pdf enabled or not
// Can be null "link_to_pdf_enabled": true, // Shows the service category of the directory
// Can be null "service_category": ServiceCategory::Index, // Shows the link to the schedule enabled or not
// Cannot be null "link_to_schedule_enabled": true, // Opening Hours of the location directory
// Can be null "opening_hours": [ DirectoryOpeningHours::Index ] }

ServiceCategory::Index

        The service category entity represents a category associated to some services, primarely used for grouping
        services with different activities based on some common factors or for marketing purposes.

{
// Persistent identifier of the entity
// Cannot be null "id": 385, // The name of the service category
// Cannot be null "name": "Some string", // The name to be displayed within the app
// Cannot be null "name_in_member_app": "Some string", // The description of the service category
// Can be null "description": "Some string", // The URL to the service category logo, if specified
// Can be null "logo_url": "Some string", // The direct URL to the service category video file, if specified
// Can be null "video_url": "Some string" }

DirectoryOpeningHours::Index

        This entity represents location record of a directory(location) opening hours model.

{
// Persistent identifier of the entity
// Cannot be null "id": 151, // Persistent Identifier of the directory
// Cannot be null "directory_id": 664, // Вescription of the location directory
// Can be null "title": "Some string", // Start time
// Can be null "start_time": "Some string", // End time
// Can be null "end_time": "Some string" }

Location::Show

        Represents the stripped version of the user entity

{
// The internal ID of the entity
// Cannot be null "id": 60, // The Region ID of Location
// Can be null "region_id": 522, // The name of the entity
// Cannot be null "title": "Some string", // The description of the entity
// Cannot be null "description": "Some string", // Image URL of the entity
// Cannot be null "image_url": "Some string", // The list of tag entities
// Cannot be null "tags": [ Tag::Index ] }

Tag::Index

        This entity encapsulates tag fields

{
// Persistent identifier of the entity
// Cannot be null "id": 14, // Name of the tag
// Cannot be null "name": "Some string", // Description of the tag
// Cannot be null "description": "Some string", // Translations of the tag
// Cannot be null "translations": "Some string", // The URL to the tag image, if specified
// Can be null "tag_image_url": "Some string", // Is editable?
// Cannot be null "editable": true, // Representation of Tag category which tag belongs
// Can be null "tag_category": TagCategory::Index }

TagCategory::Index

        This entity represents a tag category

{
// Persistent identifier of the entity
// Cannot be null "id": 898, // Is disabled?
// Cannot be null "disabled": true, // Human array of roles
// Cannot be null "human_user_visibility": [ "An", "Array", "Of", "Strings/Integers" ], // Contains translations data
// Cannot be null "translations": [ "An", "Array", "Of", "Strings/Integers" ], // A set of tag categories entities
// Cannot be null "tag_category_entities": [ "An", "Array", "Of", "Strings/Integers" ], // The URL to the tag category logo, if specified
// Can be null "logo_url": "Some string" }

User::Auth

        Represents an authenticated user typically returned in response to authentication attempts. This entity
        encapsulates the most essential information consumed by various flavours of sign in widgets and forms.

{
// Unique identifier of the user
// Cannot be null "id": 279, // Users's alt ID.
// Cannot be null "alt_id": "Some string", // User's club ID.
// Cannot be null "club_id": 70, // Display name of the user
// Cannot be null "name": "Some string", // E-mail of the user
// Cannot be null "email": "Some string", // URL to the avatar of the user
// Can be null "image_url": "Some string", // URL to the cover photo of the user
// Can be null "cover_photo_url": "Some string", // User role identifier
// Allowed values are: "Client", "Trainer", "Manager", "Users::Trainers::SelfEmployed", "Users::Trainers::Employed", and "IndependentTrainer"
// Cannot be null "type": "Some string", // User's home location
// Can be null "home_location_id": 701, // The name of the club
// Can be null "club_name": "Some string", // Access PIN associated with the user's account
// Can be null "access_pin": "Some string" }

Club::Auth

        Represents a club a specific user belongs to. This specific entity is intended to be used during
        authentication flow to present club's summary to the user.

{
// Unique identifier of the club
// Cannot be null "id": 786, // Display name of the club
// Cannot be null "name": "Some string", // URL to the logo of the club
// Can be null "image_url": "Some string", // IANA time zone identifier
// Cannot be null "time_zone": "Some string" }

Identity::Auth

        Represents an authentication handle which contains information used to complete
        various oAuth / external authentication flows, as well as Fisikal token, which can
        be used for password-less authentication.

{
// Unique identifier of the identity record
// Can be null "id": 931, // External system's user id, if any
// Can be null "uid": "Some string", // External system's token, if any
// Can be null "token": "Some string", // Fisikal authentication token
// Cannot be null "fisikal_token": "Some string" }

Error::Index

        Represents an error entry attached to an arbitrary model.

{
// The name of the field the error is attached to
// Cannot be null "on": "Some string", // The type of the error
// Allowed values are: "is_incorrect", "booking_allowed_in_sublocations_only", "is_not_billed", "is_already_cancelled", "is_already_refunded", "is_earlier_then_tomorrow", "conflicts", "failed", "taken", "length", "confirmation", "invalid", "presence", "format", "duplicate", "working_hours_violation", "spare_schedule_violation", "individual_appointment_requires_client", "excess", "numericality", "advance_time_restriction", "not_enough_credits", "requires_action", "booking_per_day_limit_exceeded", "booking_limit_exceeded", and "waiting_list_conflicts"
// Cannot be null "type": "Some string", // Map of validation arguments to be used (for instance, the regular expression which failed to match)
// Cannot be null "options": {
}
}

Trainer::Detailed

        Detailed representations of the trainer.

{
// Persistent identifier of the entity
// Cannot be null "id": 907, // ALT ID of the user
// Can be null "alt_id": "Some string", // Preferred title of the user
// Can be null "title": "Some string", // The name of the entity
// Cannot be null "name": "Some string", // Type of trainer
// Cannot be null "type": "Some string", // The link to the image of the entity
// Cannot be null "image_url": "Some string", // A short description about profession area
// Cannot be null "description": "Some string", // A long description to get client attention
// Cannot be null "experience": "Some string", // A long description of the qualifications
// Cannot be null "qualifications": "Some string", // Club id the trainer is associated to
// Cannot be null "club_id": "Some string", // Sets to true when the trainer is inactive
// Cannot be null "disabled": "Some string", // An associated location object
// Can be null "home_location": Location::Detailed, // An associated locations object
// Can be null "locations": [ Location::Detailed ], // An associated groups object
// Can be null "groups": [ Group::Lookup ], // The list of tag entities
// Cannot be null "tags": [ Tag::Index ] }

Location::Detailed

        This entity represents location record of a club required on detailed trainers page.

{
// Persistent identifier of the entity
// Cannot be null "id": 613, // Whether this location is hidden
// Cannot be null "hidden": true, // The ALT ID of Location
// Can be null "alt_id": 15, // Full name of the location
// Cannot be null "name": "Some string", // Short code of the location
// Cannot be null "short_code": "Some string", // Whether this location directory is hidden
// Cannot be null "directory_is_enabled": true }

Group::Lookup

        The lookup representation of the group.

{
// Persistent identifier of the entity
// Cannot be null "id": 548, // The name of the entity
// Cannot be null "title": "Some string" }

Trainer::Index

        The lookup representation of the trainer.

{
// Persistent identifier of the entity
// Cannot be null "id": 463, // ALT ID of the user
// Can be null "alt_id": "Some string", // The name of the entity
// Cannot be null "title": "Some string", // The description of the entity
// Cannot be null "description": "Some string", // The description of the entity
// Cannot be null "short_desc": "Some string", // The link to the image of the entity
// Cannot be null "image_url": "Some string" }

Trainer::Show

        Represents full trainer's profile data.

{
// Id of the trainer
// Cannot be null "id": 604, // Preferred title of the user
// Can be null "title": "Some string", // Name of the trainer
// Cannot be null "name": "Some string", // E-mail of the trainer
// Cannot be null "email": "Some string", // Qualifications of the trainer
// Can be null "qualifications": "Some string", // Biography of the trainer
// Can be null "bio": "Some string", // Type of trainer
// Cannot be null "type": "Some string", // Avatar image of the user
// Can be null "image": , // Cover photo of the user
// Can be null "cover_photo": , // Returns amounts of relationships for current user grouped by type
// Cannot be null "relationships": {
// Strength of has_package_with relationships for given client and trainer
// Cannot be null "has_package_with": 381, // Strength of has_booking_with relationships for given client and trainer
// Cannot be null "has_booking_with": 526, // Strength of has_assessment_with relationships for given client and trainer
// Cannot be null "has_assessment_with": 791, // Strength of has_workout_from relationships for given client and trainer
// Cannot be null "has_workout_from": 508, // Strength of is_allocated_to relationships for given client and trainer
// Cannot be null "is_allocated_to": 665, // Strength of has_active_package_with relationships for given client and trainer
// Cannot be null "has_active_package_with": 6 } ,
// The list of tag entities
// Cannot be null "tags": [ Tag::Index ] }

Service::Colors

        Response colors for services

{
// Persistent identifier of the entity
// Cannot be null "id": 251, // Activity category id
// Cannot be null "activity_category_id": 235, // Schedule color for header
// Cannot be null "schedule_color_header": 127, // Schedule color for header text
// Cannot be null "schedule_color_header_text": 575, // Schedule color for body
// Cannot be null "schedule_color_body": 539, // Schedule color for body text
// Cannot be null "schedule_color_body_text": 369, // Use activity schedule colors (true/false)
// Cannot be null "use_activity_schedule_colors": 53 }

Service::Index

        This entity represents a service provided by some trainers in some locations. It combines
        the information about service settings, favourite status etc.

{
// Persistent identifier of the entity
// Cannot be null "id": 232, // Maximum number of attendees
// Cannot be null "group_size": 568, // The hour part of service duration
// Cannot be null "duration_in_hours": 226, // The minute part of service duration
// Cannot be null "duration_in_minutes": 217, // The description of the service
// Can be null "declaration": "Some string", // The URL to the service logo image, if specified
// Can be null "logo_url": "Some string", // The URL to the service image, if specified
// Can be null "service_image_url": "Some string", // The direct URL to the service video file, if specified
// Can be null "video_url": "Some string", // The title of the service
// Cannot be null "service_title": "Some string", // Whether the current user has marked the service as a favourite
// Cannot be null "starred": true, // Show free spaces
// Cannot be null "show_free_spaces": true, // Trainer remains available
// Cannot be null "trainer_availability": true, // Stay visible on timetable until end of duration
// Cannot be null "visible_until_end": true, // The list of tag entities
// Cannot be null "tags": [ Tag::Index ] }

Service::Show

        The extended version of the service entity which represents a service provided by some trainers in some locations. It combines
        the information about service settings, favourite status etc.

{
// Persistent identifier of the entity
// Cannot be null "id": 273, // Maximum number of attendees
// Cannot be null "group_size": 738, // The hour part of service duration
// Cannot be null "duration_in_hours": 322, // The minute part of service duration
// Cannot be null "duration_in_minutes": 920, // The description of the service
// Can be null "declaration": "Some string", // The URL to the service logo image, if specified
// Can be null "logo_url": "Some string", // The URL to the service image image, if specified
// Can be null "service_image_url": "Some string", // The direct URL to the service video file, if specified
// Can be null "video_url": "Some string", // The title of the service
// Cannot be null "service_title": "Some string", // Whether the current user has marked the service as a favourite
// Cannot be null "starred": true, // Show free spaces
// Cannot be null "show_free_spaces": true, // Trainer remains available
// Cannot be null "trainer_availability": true, // Stay visible on timetable until end of duration
// Cannot be null "visible_until_end": true, // The list of tag entities
// Cannot be null "tags": [ Tag::Index ] }

ActivityCategory::Index

        Represents an activity category, which is a type of activity services concern with.

{
// Persistent identifier of the entity
// Cannot be null "id": 786, // Name of the activity category
// Cannot be null "name": "Some string", // Description of the activity category
// Can be null "description": "Some string", // The URL to the logo image, if present
// Can be null "logo_url": "Some string", // Schedule color header
// Can be null "schedule_color_header": "Some string", // Schedule color header text
// Can be null "schedule_color_header_text": "Some string", // Schedule color body
// Can be null "schedule_color_body": "Some string", // Schedule coloe body text
// Can be null "schedule_color_body_text": "Some string" }

ServicePackage::Index

Represents a service package entity, which is effectively a collection of services grouped together in one purchasable unit.

{
// Unique persistent id of the entity
// Cannot be null "id": 239, // The alt ID of Package
// Cannot be null "alt_id": "Some string", // Title of the service package
// Cannot be null "name": "Some string", // Description of the service package
// Can be null "description": "Some string", // The url to the logo file associated with the service package
// Can be null "logo_url": "Some string", // The url to the image file associated with the service package
// Can be null "service_package_image_url": "Some string", // Video associated with the package
// Can be null "video": {
// The URL to the web-based player configured to play the video file
// Can be null "player_url": "Some string", // Direct URL to the video file
// Can be null "file_url": "Some string" } ,
// Regular price of the package; nil if the package is free
// Can be null "price": , // Client-specific price of the package; nil if the package is free
// Can be null "custom_price": , // Id of the product which contents is this service package; purchase use only
// Cannot be null "product_id": 411, // Whether the service package is disabled
// Cannot be null "disabled": true, // Service category id
// Can be null "service_category_id": "Some string", // Price of the service package
// Can be null "cost": "Some string", // Service category name
// Cannot be null "service_category_name": "Some string", // Whether the service package is expirable
// Can be null "expirable": true, // Type of expiration
// Allowed values are: "day", "week", and "month"
// Can be null "expires_period_type": "Some string", // Value of expiration
// Can be null "expires_in": 775, // Type of expiration for related credits
// Allowed values are: :default, :custom, and :unexpirable
// Cannot be null "credits_expiration_type": "Some string", // Number of days when user can use credits after package expiration
// Can be null "credits_expire_after_days": 557, // Is package restricted to single trainer
// Can be null "restrict_bookings_to_payee": true, // Whether Client must complete Assessment to purchase or not
// Cannot be null "clients_require_assessment": true, // Id of package payee
// Can be null "payee_id": 37, // Roles this service package is visible to
// Cannot be null "user_visibility": [ UserVisibility::Index ], // A collection of service package services
// Cannot be null "service_package_services": [ ServicePackageService::Lookup ] }

UserVisibility::Index

        This enum represents possible values for user visibiltiy settings.

{
// Visible to users with Client role
// Cannot be null "Client" // Visible to users with Trainer role
// Cannot be null "Trainer" // Visible to users with Manager role
// Cannot be null "Manager" // Visible to users with Independent Trainer role
// Cannot be null "IndependentTrainer" // Visible to users with Content Provider role
// Cannot be null "ContentProvider" // Visible to users with Content User role
// Cannot be null "ContentUser" // Visible to users with SjdAccountant role
// Cannot be null "SjdAccountant" // Visible to users with Administrator role
// Cannot be null "Administrator" // Visible to users with FOHM role
// Cannot be null "FrontHouseManager" // Visible to users with PT Manager role
// Cannot be null "PtManager" }

ServicePackageService::Lookup

Represents a service package service entity.

{
// Unique persistent id of the entity
// Cannot be null "id": 350, // Amount of credits to be added when assigning the package
// Cannot be null "amount": "Some string", // Associated service object
// Cannot be null "service": Service::Lookup }

Service::Lookup

        The lookup representation of the service.

{
// Persistent identifier of the entity
// Cannot be null "id": 295, // The name of the entity
// Cannot be null "title": "Some string", // The description of the entity
// Cannot be null "description": "Some string", // The link to the image of the entity
// Cannot be null "image_url": "Some string" }

ServicePackage::Show

Represents a service package entity, which is effectively a collection of services grouped together in one purchasable unit.

{
// Unique persistent id of the entity
// Cannot be null "id": 680, // The alt ID of Package
// Cannot be null "alt_id": "Some string", // Title of the service package
// Cannot be null "name": "Some string", // Description of the service package
// Can be null "description": "Some string", // The url to the logo file associated with the service package
// Can be null "logo_url": "Some string", // The url to the image file associated with the service package
// Can be null "service_package_image_url": "Some string", // Video associated with the package
// Can be null "video": {
// The URL to the web-based player configured to play the video file
// Can be null "player_url": "Some string", // Direct URL to the video file
// Can be null "file_url": "Some string" } ,
// Regular price of the package; nil if the package is free
// Can be null "price": , // Client-specific price of the package; nil if the package is free
// Can be null "custom_price": , // Id of the product which contents is this service package; purchase use only
// Cannot be null "product_id": 805, // Whether the service package is disabled
// Cannot be null "disabled": true, // Service category id
// Can be null "service_category_id": "Some string", // Price of the service package
// Can be null "cost": "Some string", // Service category name
// Cannot be null "service_category_name": "Some string", // Whether the service package is expirable
// Can be null "expirable": true, // Type of expiration
// Allowed values are: "day", "week", and "month"
// Can be null "expires_period_type": "Some string", // Value of expiration
// Can be null "expires_in": 128, // Type of expiration for related credits
// Allowed values are: :default, :custom, and :unexpirable
// Cannot be null "credits_expiration_type": "Some string", // Number of days when user can use credits after package expiration
// Can be null "credits_expire_after_days": 908, // Is package restricted to single trainer
// Can be null "restrict_bookings_to_payee": true, // Whether Client must complete Assessment to purchase or not
// Cannot be null "clients_require_assessment": true, // Id of package payee
// Can be null "payee_id": 212, // Roles this service package is visible to
// Cannot be null "user_visibility": [ UserVisibility::Index ], // A collection of service package services
// Cannot be null "service_package_services": [ ServicePackageService::Lookup ], // The list of tag entities used as restictions for relation service_packages and occurrences
// Cannot be null "tags": [ Tag::Index ], // The list of tag entities for possible search by tags
// Cannot be null "service_package_tags": [ Tag::Index ] }

ServiceWorkingTime::Lookup

        Represents lookup variant of service working time entity.

{
// The internal ID of the entity
// Cannot be null "id": 544, // The name of the entity
// Cannot be null "title": "Some string", // The description of the entity
// Cannot be null "description": "Some string", // Image URL of the entity
// Cannot be null "image_url": "Some string" }

ServiceWorkingTime::Index

        This entity represents a single service working time.

{
// Persistent identifier of the entity
// Cannot be null "id": 532, // The name of the entity
// Cannot be null "title": "Some string", // The type of the payroll scheme
// Cannot be null "color": "Some string", // Flag indicating the SDH refers to standard working times
// Can be null "standard": true, // A flag representing does the entity is inactive
// Can be null "disabled": true, // Whether the current user can edit working times belonging to this SDH
// Cannot be null "editable": true, // A list of service entities
// Cannot be null "services": [ Service::Lookup ] }

WorkingTime::Index

        Represents a working time.

{
// Persistent identifier of the entity
// Cannot be null "id": 150, // Date
// Cannot be null "date": "Some string", // Color of the working time
// Can be null "color": "Some string", // Start time of the interval
// Cannot be null "start_time": 852, // End time of the interval
// Cannot be null "end_time": 996, // Duration in minutes
// Cannot be null "location": Location::Index, // Service working time attahced to this entity
// Cannot be null "service_working_time": ServiceWorkingTime::Lookup }

Occurrence::Index

        Represents an occurrence.

{
// Persistent identifier of the entity
// Cannot be null "id": 693, // UTC time this occurrence starts at
// Cannot be null "occurs_at": "2026-06-16T11:55:07Z", // Hours part of the duration
// Cannot be null "duration_in_hours": 920, // Minutes part of the duration
// Cannot be null "duration_in_minutes": 702, // Status of occurrence
// Cannot be null "status": "Some string", // The club time zone
// Cannot be null "time_zone": "Some string", // Optional notes attached to the occurrence
// Can be null "notes": "Some string", // The name of the location this event occurs in
// Cannot be null "location_name": "Some string", // The name of the sub location this event occurs in
// Can be null "sub_location_name": "Some string", // The title of the service this event is about
// Cannot be null "service_title": "Some string", // The description of the service this event is about
// Can be null "service_description": "Some string", // The maximum number of attendees allowed
// Cannot be null "service_group_size": 701, // Id of trainer associated with occurrence
// Cannot be null "trainer_id": 65, // Trainer name
// Cannot be null "trainer_name": "Some string", // Activity ID
// Cannot be null "activity_category_id": 133, // Number of free slots
// Cannot be null "spare_slots": 435, // Number of attended clients
// Cannot be null "total_booked": 803, // Number of attended clients
// Cannot be null "total_attended": 689, // true if event stays visible on timetable until end of duration
// Cannot be null "visible_until_end": true, // A comma-separated list of client names
// Cannot be null "active_clients": [ User::Lookup ], // The list of tag entities
// Cannot be null "tags": [ Tag::Index ], // The list of tag entities
// Cannot be null "service_tags": [ Tag::Index ] }

User::Lookup

        Represents the stripped version of the user entity

{
// The internal ID of the entity
// Cannot be null "id": 693, // The name of the entity
// Cannot be null "title": "Some string", // The description of the entity
// Cannot be null "description": "Some string", // Image URL of the entity
// Cannot be null "image_url": "Some string", // Square Image URL of the entity
// Cannot be null "icon_url": "Some string", // Users's alt ID.
// Cannot be null "alt_id": "Some string" }