Platform API v1.0

Ship AI scheduling in minutes

Build powerful scheduling integrations with our comprehensive API. Connect calendars, manage bookings, and automate scheduling workflows.

1

Get Your API Key

Sign up and generate your API credentials from the dashboard.

Get Started
2

Make Your First Call

Authenticate and test the API with a simple request.

View Example
3

Build Your Integration

Use our SDKs and endpoints to power your scheduling.

Explore API

Lightning Fast

Sub-50ms response times globally

Enterprise Security

SOC 2 compliant with encryption

Global Scale

Multi-region deployment with 99.99% uptime

Your First API Request

Authenticate using your API key and secret in the request headers:

curl -X GET https://api.vardacal.com/api/v1/platform/usage \
  -H "X-API-Key: vca_live_sk_your_api_key" \
  -H "X-API-Secret: your_api_secret"
const response = await fetch('https://api.vardacal.com/api/v1/platform/usage', {
  headers: {
    'X-API-Key': 'vca_live_sk_your_api_key',
    'X-API-Secret': 'your_api_secret'
  }
});

const usage = await response.json();
console.log(usage.data);
import requests

response = requests.get(
    'https://api.vardacal.com/api/v1/platform/usage',
    headers={
        'X-API-Key': 'vca_live_sk_your_api_key',
        'X-API-Secret': 'your_api_secret'
    }
)

usage = response.json()
print(usage['data'])
require 'net/http'
require 'json'

uri = URI('https://api.vardacal.com/api/v1/platform/usage')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['X-API-Key'] = 'vca_live_sk_your_api_key'
request['X-API-Secret'] = 'your_api_secret'

response = http.request(request)
usage = JSON.parse(response.body)
puts usage['data']

Response

{
  "data": {
    "account": {
      "id": 123,
      "plan": "starter",
      "api_key": "vca_live_sk_abc123..."
    },
    "current_month": {
      "month": "October 2024",
      "bookings": {
        "used": 245,
        "limit": 500,
        "percentage": 49.0
      },
      "api_calls": {
        "used": 8456,
        "limit": 10000,
        "percentage": 84.56
      }
    }
  }
}

Base URL

https://api.vardacal.com/api/v1/platform

All Platform API endpoints are relative to this base URL.

API Tiers & Pricing

Free

$0/mo
60 req/min
  • Basic API access
  • Public endpoints

Pro Solo

$29/mo
300 req/min
  • Full API access
  • Webhooks
  • Custom integrations

Pro Team

$49/mo
600 req/min
  • Team management
  • Shared resources
  • Analytics
POPULAR

Platform

$99/mo
3000 req/min
  • Multi-tenant support
  • User impersonation
  • White-label options

Official SDKs

Use our official client libraries to get started even faster with full type safety and auto-completion:

📦

JavaScript / TypeScript

npm

Full TypeScript support with axios

npm install @vardacal/sdk
import { BookingsApi } from '@vardacal/sdk';

const api = new BookingsApi(config);
const bookings = await api.listBookings();
🐍

Python

pip

Type hints and Pydantic models

pip install vardacal
from vardacal.api import bookings_api

api = bookings_api.BookingsApi(client)
bookings = api.list_bookings()
💎

Ruby

gem

Idiomatic Ruby with Typhoeus

gem install vardacal
api = VardaCal::BookingsApi.new

bookings = api.list_bookings

🚀 Coming Soon: SDKs will be published to npm, PyPI, and RubyGems. For now, download the SDK from the links above and follow the README for local installation.

Complete Code Examples

Download runnable examples in your preferred language to get started quickly:

💡 Quick Start: Each example includes a README with setup instructions. Copy .env.example to .env, add your API credentials, and run!

Next Steps