Quickstart

Quickstart

This guide shows the shortest path from no context to a working Vytal API
integration.

1. Read the contract

Start with the Developer API hub and the
OpenAPI spec.

2. Sign in

curl -X POST https://api.vytal.fit/auth/sign-in/email \
  -H 'content-type: application/json' \
  -d '{"email":"[email protected]","password":"VytalDemo2026!"}'

3. Fetch the session

curl https://api.vytal.fit/auth/get-session \
  -H 'authorization: Bearer <token>'

4. Load spaces

curl https://api.vytal.fit/spaces \
  -H 'authorization: Bearer <token>'

5. Switch the active space

curl -X PATCH https://api.vytal.fit/session \
  -H 'content-type: application/json' \
  -H 'authorization: Bearer <token>' \
  -d '{"activeSpaceId":"org_123"}'

6. Make a business request

Once the session is active, the same token can be used for bookings, records,
and results.

curl -X GET 'https://api.vytal.fit/bookings?memberId=mem_123' \
  -H 'authorization: Bearer <token>'

What to expect

  • Responses use JSON.
  • Filters use query parameters.
  • Writes return the created or updated entity.
  • Missing org context should fail clearly instead of leaking data.