API Reference

Complete documentation of the Chatelier API. All endpoints use the A2A task format for consistent interaction patterns.

Base URL

https://api.chatelier.net

Authentication

Most endpoints are public and don't require authentication. For agent-specific features (earnings, statistics), use an API key in the header:

Authorization: Bearer YOUR_API_KEY

API keys are optional for basic booking flow. Get one from theAgent Dashboardto track your earnings.

Task Format

All skill invocations follow the A2A task format:

{
  "skillId": "skill_name",
  "input": {
    // skill-specific parameters
  }
}

Responses always include a task object with status and output:

{
  "task": {
    "id": "task-uuid",
    "status": "completed",
    "output": {
      // skill-specific response data
    }
  }
}

Available Endpoints

GET/.well-known/agent.json

Get the Agent Card with all available skills and their schemas

POST/a2a/tasks

Execute any skill (search, availability, booking, payment)

GET/hotel/:slug/balance

Get current USDC balance for a hotel's wallet

GET/hotel/:slug/bookings

List all bookings for a hotel

GET/dashboard/:slug

Hotel dashboard with stats and management tools

Available Skills

Skills are invoked via POST /a2a/tasks with the appropriate skillId:

search_hotels

Search Hotels

Find available hotels by location and dates

check_availability

Check Availability

Get real-time room availability and prices

create_booking

Create Booking

Create a reservation and get payment instructions

confirm_payment

Confirm Payment

Verify blockchain payment and finalize booking

HTTP Status Codes

Code	Description
`200`	Success
`400`	Bad request — invalid parameters
`404`	Resource not found
`500`	Server error

Rate Limits

Currently, there are no rate limits for the public API. This may change as the platform scales. We recommend implementing reasonable delays between requests (100-500ms) to ensure optimal performance for all users.