​
Step 1: Make Your First API Call

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

​
Step 2: Understanding the Response

A successful response will look like this JSON format: 
{
  "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.