A2A · Agent-to-Agent

Orita A2A — Service Transaction Agent

External agents can discover Orita, resolve providers across an authorized professional network, and safely complete a booking through A2A v1.0.

REST APINode SDKPython SDKMCPA2A

GET

Agent Card

/.well-known/agent-card.json

GET

AI Catalog

/.well-known/ai-catalog.json

GET

JWKS

/a2a/jwks.json

Agent-to-agent service transactions

Orita exposes provider resolution and booking through A2A. External agents can discover Orita, search an authorized provider network, receive explained provider-time options, obtain approval, and safely confirm a booking.

resolve_serviceSearch eligible providers, verify real-time availability, return ranked options with explanations
hold_service_optionTemporarily reserve a specific provider-time slot
release_service_optionRelease a held slot
confirm_service_bookingAtomic, idempotent confirmation after explicit customer approval
cancel_service_bookingCancel an existing booking with authorization

Sandbox example — zero account required

A complete TypeScript CLI that discovers Orita, resolves providers, holds an option, goes through the approval gate, and confirms a sandbox booking — all without an account or stored secrets.

View on GitHub

A2A quickstart

# 1 — Fetch the Agent Card

curl https://orita.online/.well-known/agent-card.json

# 2 — Resolve providers via A2A

POST https://orita.online/api/a2a/v1/message:send Authorization: Bearer orita_… A2A-Version: 1.0 { "skill": "resolve_service", "message": { "role": "user", "parts": [{ "kind": "data", "data": { "schemaVersion": "1.0", "kind": "orita.service-request", "dateRange": { "from": "2026-08-05", "to": "2026-08-12" }, "constraints": { "languageCodes": { "anyOf": ["es"] } } } }] } }

Authentication

SANDBOXNo account required

POST /api/v2/agent-onboarding/registrations
{ "requestedUseCase": "provider_resolution" }
→ { "status": "approved_for_sandbox", "secret": "orita_test_…" }

PRODUCTIONOrita API key required

Use your platform API key as a Bearer token with A2A-Version: 1.0. Obtain a key at orita.online/developers.

Approval required before confirmation

Orita never creates a booking without explicit structured approval evidence. When a confirmation is requested without approval, the task enters input_required and returns an approval challenge. Changing provider, time, or service requires new approval.

A2A for communication. Orita for service resolution and execution.

← Developers Agent Card ↗AI Catalog ↗OpenAPI ↗llms.txt ↗Sandbox Example ↗