div div div div span \ span developers & partners hub div div h1 Build span Powerful Integrations span _ p Official API documentation for integrating online booking, CRM, scheduling, POS, and business management features into your applications div div div 200+ div API endpoints div div 99.98% div Platform uptime div div 5+ div New integrations per day div a Start Here a Browse APIs a Get API Key div div div span i i i span b altegio-app — r2-d2 div div span svg rect rect rect rect rect rect rect rect rect rect rect div div b R2D2 Code span vibe build div r2-unit · ∞ context · maximum beeps div ~/altegio-app · span ● online div b Tip: paste an API's docs and I'll wire it up. div div span > span build an extension for my business platform — docs at developer.alteg.io div span ● *beep-boop!* Altegio's docs are chef's-kiss — 200+ typed endpoints, real examples. What should it do? div span ✳ computing · bloop · whirr div span > span an AI agent that DMs me a daily report div span ● *whistle* — on it, wiring it up: div span ⏺ span read yesterday's numbers span ✓ div span ⏺ span write a tidy summary span ✓ div span ⏺ span ping the owner at 9:00 sharp span ✓ div span ● *bee-doo!* Your b report-droid is live 🤖 div span > span span span ask r2-d2 anything… div div ~/altegio-app · r2-unit · ctx 94% div ▶▶ droid mode on · shift+tab to cycle div div div span \ span quickstarts span span 01 / 06 h2 New to Altegio? span Start Here p Pick the route that matches what you are building. Each guide explains exactly which credentials you need and what to do next. div a h3 API v1, v2 & Online Booking p Register, get your Partner Token and User Token, and learn the authorization header used by the live APIs div Get credentials a h3 Marketplace App p Install a draft app on your own test Location, activate it, and make authenticated calls before moderation div Install & test a h3 Integrations Hub MCP p Connect an AI assistant to plan, create, configure, and test your own marketplace application div Connect MCP div div div span \ span api surfaces span span 02 / 06 h2 Available span APIs p Four specialized APIs for different integration scenarios div a h3 Online Booking p Public endpoints for booking widgets and client portals. No user authentication required div Explore a span Recommended h3 Business Management span v2 p Complete business operations API with improved design. New features are released here first. Recommended for new integrations div Explore a h3 Business Management span v1 p Full-featured API for all business operations: scheduling, POS, CRM, inventory, finances, loyalty. Maintained for backward compatibility div Explore a h3 Developer Tools p Webhooks, dictionaries, and integration tools for marketplace app developers div Explore a div span Coming Soon — October 2026 h3 Business Management span v3 p Contract prototype only — V3 is not ready and cannot serve API calls today. Paths and schemas may still change before the planned October 2026 release. div View prototype div div div span \ span reference span span 03 / 06 div div h2 Getting Started p The Altegio API allows third-party developers to perform most operations with platform data. When designing methods, we adhered to the REST architecture. ul li All requests are encrypted with TLS 1.2+ li Rate limit: 200 requests/min or 5 requests/sec per IP li Base URL: code https://api.alteg.io/api h2 API Versioning p The API uses URL path versioning. Both V1 and V2 are production-ready. New features may be released in V2 only. V1 endpoints are maintained for backward compatibility. V3 is a contract prototype coming in October 2026 and is not callable yet. ul li strong V1 ( code /v1/... ) — Stable, full-featured API li strong V2 ( code /v2/... ) — New endpoints with improved design li strong V3 ( code /v3/... ) — Coming soon in October 2026; contract prototype only div div h4 Authentication p API requests are authorized per a RFC 6749 . Two authorization modes: p strong Partner only (public endpoints): code Authorization: Bearer < partner_token > p strong Partner + User (business data): code Authorization: Bearer < partner_token > , User < user_token > p Get the Partner Token from your a Developer Account . For the User Token, use the installed application's system user or a authorize your own Business User . Their Location access and permissions can differ. div h4 Date & Time Format code "2026-09-21T23:00:00.000-05:00" p ISO 8601 format. Durations are in seconds (e.g., 900 = 15 min) div div div span \ span support span span 04 / 06 div div h2 Developer Support p Our API team is here to help you build successful integrations. Whether you're troubleshooting an issue or planning a complex implementation, we provide technical guidance to keep your project moving forward. div div span Direct API Support span Get answers from engineers who built the API div span Integration Review span Architecture feedback before you ship div span Priority Response span Business-critical issues handled first div div span Contact API Team a api@alteg.io p Include request URL, headers, body, and response for faster resolution div div div div span Partner Program h3 Earn with Altegio p Connect clients to the platform and receive recurring commissions. Dedicated support, marketing materials, and API access included. a Learn more div span Up to span 50% span commission div div div span \ span use cases span span 05 / 06 h2 What You Can span Build p Popular integration scenarios powered by Altegio API div div div 🗓️ h4 Booking Widget p Embed scheduling into websites, mobile apps, or kiosks div div 🤖 h4 AI Assistants p Build booking agents with the API, or a manage your marketplace app with MCP div div 📊 h4 Analytics Dashboard p Build custom reports, BI integrations, data warehouses div div 🔄 h4 CRM Sync p Two-way sync with Salesforce, HubSpot, custom CRMs div div 📱 h4 White-label Apps p Build branded booking apps for your clients div div 💳 h4 POS Integration p Connect payments, receipts, fiscal printers div div 📦 h4 Inventory Automation p Sync stock levels with suppliers, e-commerce div div 🔔 h4 Custom Notifications p Webhooks for real-time events, custom messaging div div div span \ span data model span span 06 / 06 h2 Core span Entities p The API allows you to work with most of the platform's entities. Note that there are inconsistencies in the technical terminology: method and variable names may differ between the user interface and the documentation div div h3 Locations p A Location is an individual business unit that operates within the platform. Each Location belongs to a Chain. For single-location businesses, the platform still creates a single-location Chain. small Also known as: company, branch, filial, salon a Learn more → div h3 Chains p A Chain is a group of multiple Locations managed as a single business network. Chain-level settings, promotions, service catalogs, and loyalty rules may be inherited by all child Locations while each Location can still override them where needed. small Also known as: groups, networks, salon_groups a Learn more → div h3 Users p A User is an account that provides authenticated access to one or more Locations. Access scope is defined by Roles, which are predefined sets of Access Rights. If a User does not have access to a module or method, the API returns HTTP 403. Users can also be linked to Chains for Chain-level requests. Most API methods require the User to be authorised and to have explicit access to the target Location. small Also known as: account, login a Learn more → div h3 Team Members and Positions p A Team Member is an individual within a Location who participates in operational processes: provides Services within Appointments, creates or manages reservations, or works with financial and analytical data. Positions are logical groups of Team Members (similar to folders) that help structure staff by departments, functions, or specialisation. small Also known as: employee, staff, staff_member, master a Learn more → div h3 Resources p Resources are limited items required to provide Services (rooms, chairs, devices, machines). A Resource cannot be used in parallel for multiple Appointments; it is reserved when a Service linked to that Resource is booked. small Also known as: equipment, room a Learn more → div h3 Schedule & Time Slots p A Schedule is a set of time intervals during which a Team Member or Resource is available to provide Services. A Time Slot is a specific available interval within the Schedule that can be booked online for an Appointment with a Team Member. small Also known as: timetable, availability a Learn more → div h3 Appointments & Visits p An Appointment is a scheduled time interval during which a specific Team Member provides one or more Services or sells Products to a specific Client. A Visit is a group of one or more Appointments that take place during a single Client presence at a Location. Grouping rules depend on the Location settings. small Also known as: record, booking a Learn more → div h3 Events p An Event is a scheduled time slot for a group Service where multiple Clients can book simultaneously. Unlike individual Appointments, an Event has a capacity limit defining the maximum number of participants. Events are used for group classes, workshops, webinars, and any service that can serve multiple Clients at the same time. small Also known as: activity, group event a Learn more → div h3 Clients p A Client is an individual who books, receives, or has received Services or Products from a Location. Client data is used for scheduling, communication, and analytics. small Also known as: customer, visitor a Learn more → div h3 Services and Service Categories p A Service is a predefined type of work or procedure that can be provided to a Client by a Team Member within a Location. Each Service has key parameters such as duration, price (or price range), and applicable resources. Service Categories are logical groups used to organise Services for configuration, reporting, and client-facing catalogs. small Also known as: treatments, procedures a Learn more → div h3 Products and Product Categories p A Product is a tangible or consumable item that can be sold to a Client or used as part of a Service. Product Categories are logical groups used to organise Products for inventory management, reporting, and sales operations. small Also known as: goods, items a Learn more → div h3 Inventories p Inventories represent physical or logical Warehouses used to store and track Products and consumables. Inventory operations (receipts, write-offs, transfers) ensure that product usage in Visits is reflected in stock levels and financial reports. small Also known as: storages, warehouses a Learn more → div h3 Suppliers p Suppliers and Partners are counterparties used in Inventory and Finance modules to track product purchases, settlements, and mutual transactions with external companies. small Also known as: partners, vendors a Learn more → div h3 Location Accounts p Location Accounts are accounts (cash registers or bank accounts) attached to a specific Location. They are used to record payments for Visits, product sales, and other financial operations, and they define how money flows are grouped in financial reports. small Also known as: cashdesks, cash registers a Learn more → div h3 Payment Methods p Payment methods define how payments are recorded in the system (cash, card, bank transfer, online acquiring, loyalty instruments). Each method is linked to specific Accounts and can have its own commission and reporting logic. small Also known as: payment types a Learn more → div h3 Payroll Rules p Payroll rules define how staff compensation is calculated based on Visits, Products, Memberships, tips, and other metrics. They describe commission schemes, fixed payments, and deductions. small Also known as: salary, wages a Learn more → div h3 Client Cards p A Client Card is a unified profile that stores balances, active memberships, certificates, and participation in loyalty programs for a specific Client across one Location or an entire Chain. small Also known as: loyalty cards a Learn more → div h3 Memberships and their Types p A Membership is a prepaid product that gives a Client the right to receive a set number of services or discounts over a defined period. Membership Types define the rules: which services are included, how many visits are available, validity period, and usage restrictions. small Also known as: abonements, passes a Learn more → div h3 Certificates and their Types p A Certificate is a prepaid value or service voucher that can be used to pay for Services and Products. Certificate Types define how certificates are sold, accounted for, and redeemed, including validity period and usage restrictions. small Also known as: gift cards, vouchers a Learn more → div h3 Loyalty Programs p Loyalty programs combine bonus accrual, cumulative discounts and referral promotions to increase repeat visits and average spend. Any loyalty instrument must be linked to a specific Client Card so that bonuses, discounts, and balances are applied consistently across Visits. small Also known as: rewards, bonuses a Learn more → div h3 Client Accounts p Client Accounts are internal balances (deposits) stored on the Client Card. They are used to prepay future Visits, store overpayments, or keep store credit that can be partially or fully redeemed in subsequent Visits and sales. small Also known as: deposits a Learn more → div h3 Subdivisions p Subdivisions are higher-level groups used to organise Services across a Chain (for example, "Hair", "Nails", "Spa"). They help structure large catalogs, simplify analytics, and control visibility of Services in online booking. small Also known as: departments a Learn more → div h3 Custom Fields p Custom fields are additional attributes configured by the Location to store extra data in Visits or other entities (for example, medical notes, internal IDs). They extend the standard schema without changing the core data model. small Also known as: additional fields a Learn more → div h3 Tags p Tags allow users to group Clients, Appointments, or Events. They are used for analytics, targeted communications, and certain loyalty scenarios. small Also known as: labels, segments, categories a Learn more → div h3 Integrations HUB p Integrations HUB is a catalog of external applications and services connected to Altegio (telephony, messaging, CRM, loyalty, etc.). It standardises how integrations are discovered, installed, configured, and monetised. small Also known as: marketplace, apps a Build with Integrations Hub MCP → a Learn more →