# Nomad Circle API Documentation

Nomad Circle exposes a website API for membership applications, authentication, member profile actions, curated experiences, regions, content, and contact messages.

## Discovery

- OpenAPI specification: https://nomadcircle.sa/openapi.json
- API base URL: https://nomadcircle.sa/

## Authentication

- Authorization server metadata: https://nomadcircle.sa/.well-known/oauth-authorization-server
- Protected resource metadata: https://nomadcircle.sa/.well-known/oauth-protected-resource
- Public browsing endpoints do not require authentication.
- Member-specific endpoints use the website email OTP session flow and expect the opaque bearer token issued by that flow.
- The bearer token is a Better Auth session token, not a JWT.

## Zero-auth public endpoints

- Categories: https://nomadcircle.sa/api/v1/website/experiences/categories
- Regions: https://nomadcircle.sa/api/v1/website/experiences/regions
- Experiences: https://nomadcircle.sa/api/v1/website/experiences
- Site settings: https://nomadcircle.sa/api/v1/website/settings

## Health

- Health endpoint: https://nomadcircle.sa/api/health