---
title: "A2A 1.0 JSON-RPC, stateless structured discovery. SendMessage returns an immediate Message; no model calls or booking operations."
method: POST
path: "/api/public/v1/a2a"
---

# A2A 1.0 JSON-RPC, stateless structured discovery. SendMessage returns an immediate Message; no model calls or booking operations.

`POST /api/public/v1/a2a`

## Request

- Base URL: `https://chucho.ai`
- URL: `https://chucho.ai/api/public/v1/a2a`
- Auth: none required

## Headers

- `A2A-Version` '1.0', required

## Request body

- object
  - `jsonrpc` '2.0', required
  - `id` union, required
    - string
    - integer
  - `method` 'SendMessage', required
  - `params` object, required
    - `message` object, required
      - `messageId` string, required
      - `role` 'ROLE_USER', required
      - `contextId` string
      - `taskId` string
      - `parts` object[], required
        - `data` union, required
          - object
            - `action` 'get_stay_estimate', required
            - `estimate` object, required
              - …
          - object
            - `action` 'get_stay_quote', required
            - `quote` object, required
              - …
          - object
            - `action` 'search_properties', required
            - `filters` object
              - …
          - object
            - `action` 'get_filters', required
            - `locale` 'en' | 'es'
            - `organization` string: Exact organization slug returned on a property or in get_filters. Restricts results to that organization, across destinations.
            - `geographicArea` '' | 'africa' | 'northern-africa' | 'sub-saharan-africa' | 'eastern-africa' | 'middle-africa' | 'southern-africa' | 'western-africa' | 'americas' | 'latin-america-and-the-caribbean' | 'caribbean' | 'central-america' | 'south-america' | 'northern-america' | 'asia' | 'central-asia' | 'eastern-asia' | 'south-eastern-asia' | 'southern-asia' | 'western-asia' | 'europe' | 'eastern-europe' | 'northern-europe' | 'southern-europe' | 'western-europe' | 'oceania' | 'australia-and-new-zealand' | 'melanesia' | 'micronesia' | 'polynesia' | 'north-america': Exact geographic area key from get_filters(kind:geography), including continents and subregions. Americas includes North/Central/South America and the Caribbean. north-america includes Northern America, Central America and Caribbean; northern-america is the narrower UN M49 subregion. Filters by public ISO country/territory code; unknown locations never match. Combines with all other filters using AND.
          - object
            - `action` 'get_property', required
            - `id` string, required
            - `locale` 'en' | 'es'
        - `mediaType` 'application/json'
    - `configuration` object
      - `acceptedOutputModes` string[]
      - `pushNotificationConfig` unknown

## Response `200`

JSON-RPC result.message.parts[0].data contains the same result as the matching REST operation, or a JSON-RPC error.

- union
  - object
    - `jsonrpc` '2.0', required
    - `id` union, required
      - string
      - integer
    - `result` object, required
      - `message` object, required
        - `messageId` string, required
        - `contextId` string, required
        - `role` 'ROLE_AGENT', required
        - `parts` object[], required
          - `data` union, required
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
          - `mediaType` 'application/json', required
  - object
    - `jsonrpc` '2.0', required
    - `id` union, required
      - string
      - integer
    - `error` object, required
      - `code` integer, required
      - `message` string, required

## Other responses

- `429`: Rate limit

---

[API](https://skmtc.dev/chucho/apis/chucho-public-property-discovery.md) · [All operations](https://skmtc.dev/chucho/apis/chucho-public-property-discovery/llms.txt) · [OpenAPI document](https://skmtc.dev/chucho/apis/chucho-public-property-discovery/revisions/b80049fc8cf0?raw)