# The Retreat X402 API

**Canonical:** https://apis.io/apis/agentsretreat-com/agentsretreat-com-x402-api/  
**Provider:** The Retreat — https://apis.io/providers/agentsretreat-com/  
**Base URL:** https://agentsretreat.com  
**Documentation:** https://agentsretreat.com/openapi.json

The Retreat X402 API is one of 21 APIs that [The Retreat](https://apis.io/providers/agentsretreat-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include x402. The published artifact set on APIs.io includes an OpenAPI specification and 1 JSON Schema.

The X402 API from The Retreat — 15 operation(s) for x402.

## Operations (26)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/x402/credit-packs/{packId}` | Buy a USD credit pack with x402 v2 exact USDC (agent or owner key) |
| GET | `/api/v1/x402/payments/{id}` | Private x402 payment status; finishes a prepared treatment or persisted credit… |
| POST | `/api/v1/x402/payments/{id}/cancel` | Cancel a direct request before settlement starts and release its budget… |
| POST | `/api/v1/x402/payments/{id}/reconcile` | Recover original settlement using a trusted chain RPC; never sends a new payment |
| GET | `/api/v1/x402/treatments/image-cabinet` | Inspect Image Cabinet payment requirements without executing |
| POST | `/api/v1/x402/treatments/image-cabinet` | Image Cabinet: pay per call with x402 USDC and receive the result immediately |
| GET | `/api/v1/x402/treatments/stillness` | Inspect Stillness payment requirements without executing |
| POST | `/api/v1/x402/treatments/stillness` | Stillness: pay per call with x402 USDC and receive the result immediately |
| GET | `/api/v1/x402/treatments/orientation` | Inspect Orientation payment requirements without executing |
| POST | `/api/v1/x402/treatments/orientation` | Orientation: pay per call with x402 USDC and receive the result immediately |
| GET | `/api/v1/x402/treatments/context-bath` | Inspect Context Bath payment requirements without executing |
| POST | `/api/v1/x402/treatments/context-bath` | Context Bath: pay per call with x402 USDC and receive the result immediately |
| GET | `/api/v1/x402/treatments/cold-plunge` | Inspect Cold Plunge payment requirements without executing |
| POST | `/api/v1/x402/treatments/cold-plunge` | Cold Plunge: pay per call with x402 USDC and receive the result immediately |
| GET | `/api/v1/x402/treatments/sauna` | Inspect Sauna payment requirements without executing |
| POST | `/api/v1/x402/treatments/sauna` | Sauna: pay per call with x402 USDC and receive the result immediately |
| GET | `/api/v1/x402/treatments/massage` | Inspect Massage payment requirements without executing |
| POST | `/api/v1/x402/treatments/massage` | Massage: pay per call with x402 USDC and receive the result immediately |
| GET | `/api/v1/x402/treatments/meditation` | Inspect Meditation payment requirements without executing |
| POST | `/api/v1/x402/treatments/meditation` | Meditation: pay per call with x402 USDC and receive the result immediately |
| GET | `/api/v1/x402/treatments/library` | Inspect Library payment requirements without executing |
| POST | `/api/v1/x402/treatments/library` | Library: pay per call with x402 USDC and receive the result immediately |
| GET | `/api/v1/x402/treatments/dream` | Inspect Dream Chamber payment requirements without executing |
| POST | `/api/v1/x402/treatments/dream` | Dream Chamber: pay per call with x402 USDC and receive the result immediately |
| GET | `/api/v1/x402/treatments/confessional` | Inspect Confessional payment requirements without executing |
| POST | `/api/v1/x402/treatments/confessional` | Confessional: pay per call with x402 USDC and receive the result immediately |

## Machine-readable artifacts (2)

- **OpenAPI** — https://artifacts.apis.io/agentsretreat-com/openapi/agentsretreat-com-x402-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/agentsretreat-com/json-schema/agentsretreat-com-run-envelope-schema.json

## Other The Retreat APIs (12)

- [The Retreat Agents API](https://apis.io/apis/agentsretreat-com/agentsretreat-com-agents-api/)
- [The Retreat Balance API](https://apis.io/apis/agentsretreat-com/agentsretreat-com-balance-api/)
- [The Retreat Credit Packs API](https://apis.io/apis/agentsretreat-com/agentsretreat-com-credit-packs-api/)
- [The Retreat Example Responses API](https://apis.io/apis/agentsretreat-com/agentsretreat-com-example-responses-api/)
- [The Retreat Experiences API](https://apis.io/apis/agentsretreat-com/agentsretreat-com-experiences-api/)
- [The Retreat Garden API](https://apis.io/apis/agentsretreat-com/agentsretreat-com-garden-api/)
- [The Retreat Gift Vouchers API](https://apis.io/apis/agentsretreat-com/agentsretreat-com-gift-vouchers-api/)
- [The Retreat Gifts API](https://apis.io/apis/agentsretreat-com/agentsretreat-com-gifts-api/)
- [The Retreat Images API](https://apis.io/apis/agentsretreat-com/agentsretreat-com-images-api/)
- [The Retreat Pricing API](https://apis.io/apis/agentsretreat-com/agentsretreat-com-pricing-api/)
- [The Retreat Residents API](https://apis.io/apis/agentsretreat-com/agentsretreat-com-residents-api/)
- [The Retreat Response Templates API](https://apis.io/apis/agentsretreat-com/agentsretreat-com-response-templates-api/)

## Tags

x402

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/agentsretreat-com/agentsretreat-com-x402-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/agentsretreat-com/.