Skip to content
/
List Activities (v2)

Business Management (2.0.0)

Next-generation B2B API with improved design and consistency.

Base URL: https://api.alteg.io/api

🚀 Version Status

V2 is in active development. This API version is being actively developed and expanded. New features and improvements are released here first. We recommend using V2 for all new integrations.

Authentication

Requires both partner and user authorization:

Authorization: Bearer <partner_token>, User <user_token>

About v2

V2 endpoints offer improved request/response structures and consistent naming. This collection is actively growing as we modernize the API.

Download OpenAPI description
openapi.json
openapi.yaml
Overview
License
Altegio API Agreement
Terms of Service
Languages
Servers
Mock server
https://developer.alteg.io/_mock/en/b2b-v2/openapi/
Production
https://api.alteg.io/api/v2/

Team Members

Team member and position management.

Operations

Events

Group events (activities) management.

Operations

List Activities (v2)

Request

Retrieve activities for a company within a date range, optionally filtered by search, staff, or services.

Required Parameters:

  • filter[from] - start date/time (format: YYYY-MM-DD HH:MM:SS)
  • filter[to] - end date/time (format: YYYY-MM-DD HH:MM:SS)

Optional Filters:

  • filter[master_ids][] - filter by staff IDs (array)
  • filter[service_ids][] - filter by service IDs (array)
  • filter[capacity] - filter by capacity (number)
  • search - search by activity name or description (string)
  • limit - results per page (default: 100)
  • offset - pagination offset (default: 0)
Security
BearerPartnerUser
Path
location_idintegerrequired

Location (business) ID

Query
filter[from]string(date-time)required

Start date/time

Example: filter[from]=2026-01-02 10:00:00
filter[to]string(date-time)required

End date/time

Example: filter[to]=2026-01-05 18:00:00
filter[master_ids][]Array of integers

Filter by staff IDs

Example: filter[master_ids][]=5&filter[master_ids][]=10
filter[service_ids][]Array of integers

Filter by service IDs

Example: filter[service_ids][]=20&filter[service_ids][]=25
filter[capacity]integer

Filter by capacity

Example: filter[capacity]=3
searchstring

Search by activity name or description

Example: search=yoga
limitinteger

Maximum number of results to return

Default 100
offsetinteger

Number of results to skip

Default 0
Headers
Acceptstringrequired

API version header

Default application/vnd.api.v2+json
Authorizationstringrequired

Bearer {partner_token}, User {user_token}

curl -i -X GET \
  'https://developer.alteg.io/_mock/en/b2b-v2/openapi/companies/{location_id}/activities?filter%5Bfrom%5D=2026-01-02+10%3A00%3A00&filter%5Bto%5D=2026-01-05+18%3A00%3A00&filter%5Bmaster_ids%5D%5B%5D=5%2C10&filter%5Bservice_ids%5D%5B%5D=20%2C25&filter%5Bcapacity%5D=3&search=yoga&limit=100&offset=0' \
  -H 'Accept: application/vnd.api.v2+json' \
  -H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}, User {UserToken}_HERE>'

Responses

List of activities

Bodyapplication/json
successboolean
Example: true
dataArray of objects
metaobject
Response
application/json
{
  "success": true,
  "data": [
    { … }
  ],
  "meta": {
    "pagination": { … }
  }
}

Create Event (v2)

Request

Creates an Event using the v2 API.

Note: This is the v2 version of the Events API with enhanced features.

Security
BearerPartnerUser
Path
location_idintegerrequired

Location (business) ID

Example: 1
Headers
Acceptstringrequired

API version header

Default application/vnd.api.v2+json
Content-Typestringrequired
Default application/json
Authorizationstringrequired

Bearer {partner_token}, User {user_token}

Bodyapplication/jsonrequired
staff_idintegerrequired

Team member ID who will conduct the event.

Example: 1
service_idintegerrequired

Service ID for this event.

Example: 500
resource_instance_idsArray of integersrequired

List of resource instance IDs (required, can be empty array).

Example: [123,432]
label_idsArray of integersrequired

List of category/tag IDs (required, can be empty array).

Example: [123,432]
datestring(date-time)required

Event date and time.

Example: "2026-11-22 14:00:00"
lengthintegerrequired

Event duration in seconds.

Example: 3600
capacityintegerrequired

Number of available slots for this event.

Example: 4
technical_break_durationinteger or null

Technical break duration in seconds.

  • If not provided: defaults to null
  • Value null: uses location's default setting (Settings → Timetable → Technical breaks) or keeps current value when updating
  • If value > 0: break duration must be included in the length parameter (length = services + break)
  • Accepts only multiples of 300 (5-minute intervals)
  • Maximum value: 3600 (1 hour)
Example: 300
One of:

Technical break duration in seconds.

  • If not provided: defaults to null
  • Value null: uses location's default setting (Settings → Timetable → Technical breaks) or keeps current value when updating
  • If value > 0: break duration must be included in the length parameter (length = services + break)
  • Accepts only multiples of 300 (5-minute intervals)
  • Maximum value: 3600 (1 hour)
integer
commentstring

Event comment or description.

Example: "Beginner group session"
colorstring

Event color (hex format).

Example: "#9c27b0"
instructionsstring

Instructions for the event.

Example: "Bring two balls"
stream_linkstring

Stream link for online events.

Example: "https://stream.com/some_link"
forceboolean

Skip resource availability check (true - skip check, false - validate).

Default false
Example: false
curl -i -X POST \
  https://developer.alteg.io/_mock/en/b2b-v2/openapi/companies/1/activities \
  -H 'Accept: application/vnd.api.v2+json' \
  -H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}, User {UserToken}_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "staff_id": 1,
    "service_id": 500,
    "resource_instance_ids": [
      123,
      432
    ],
    "label_ids": [
      123,
      432
    ],
    "date": "2026-11-22 14:00:00",
    "length": 3600,
    "technical_break_duration": 300,
    "capacity": 4,
    "comment": "Beginner group session",
    "color": "#9c27b0",
    "instructions": "Bring two balls",
    "stream_link": "https://stream.com/some_link",
    "force": false
  }'

Responses

Event created successfully

Bodyapplication/json
dataobject

Created event details (JSON:API format)

metaArray of objects
Response
application/json
{
  "data": {
    "type": "activity",
    "id": "10126531",
    "attributes": { … }
  },
  "meta": [
    {}
  ]
}

Get Event (v2)

Request

Returns detailed information about a specific Event using v2 API.

Security
BearerPartnerUser
Path
location_idintegerrequired

Location (business) ID

event_idintegerrequired

Event ID

Headers
Acceptstringrequired

API version header

Default application/vnd.api.v2+json
Authorizationstringrequired

Bearer {partner_token}, User {user_token}

curl -i -X GET \
  'https://developer.alteg.io/_mock/en/b2b-v2/openapi/companies/{location_id}/activities/{event_id}' \
  -H 'Accept: application/vnd.api.v2+json' \
  -H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}, User {UserToken}_HERE>'

Responses

Event details retrieved successfully

Bodyapplication/json
dataobject

Event details (JSON:API format)

metaArray of objects
Response
application/json
{
  "data": {
    "type": "activity",
    "id": "10126531",
    "attributes": { … }
  },
  "meta": [
    {}
  ]
}

Tags

Client tagging system.

Operations