Skip to main content

Documentation Index

Fetch the complete documentation index at: https://apidocs.neetocal.com/llms.txt

Use this file to discover all available pages before exploring further.

The NeetoCal API is organized around REST principles and uses standard HTTP response codes. All API endpoints return JSON responses and require authentication. Before you start with NeetoCal APIs you will need the following:
  1. Workspace Subdomain.
  2. An API key.

​
Quick start

Get started with the NeetoCal API in minutes. Make your first API call and retrieve your bookings. You should have your API key and Workspace Subdomain ready with you.

​
Step 1: Make Your First API Call

Let’s retrieve all bookings in your workspace using a GET request: 
curl -X GET "https://{your-subdomain}.neetocal.com/api/external/v2/bookings" \
  -H 'X-Api-Key: your-api-key' \
  -H 'Content-Type: application/json'
Replace your-subdomain with your actual workspace subdomain and your-api-key with your actual API key.

​
Step 2: Understanding the Response

A successful response will look like this: 
{
  "bookings": [
    {
      "id": "booking-123",
      "sid": "abc123",
      "name": "John Doe",
      "email": "john@example.com",
      "host_name": "Jane Smith",
      "host_email": "jane@example.com",
      "starts_at": "2025-01-15T10:30:00Z",
      "ends_at": "2025-01-15T11:00:00Z",
      "time_zone": "America/New_York",
      "status": "confirmed",
      "created_at": "2025-01-10T15:30:00Z",
      "updated_at": "2025-01-10T15:30:00Z"
    }
  ],
  "pagination": {
    "total_records": 1,
    "total_pages": 1,
    "current_page_number": 1,
    "page_size": 30
  }
}

​
Next Steps

Now that you’ve made your first API call, you can:

Explore API reference

Browse all available endpoints and their detailed documentation.

Pagination

Understand how to paginate through API responses efficiently.

HTTP response codes

Learn what different response codes mean and how to handle them.

Need help?

Visit our help center or contact us by sending an email to support@neetocal.com.