# Instance

Server instance information and configuration. Provides metadata about the server, compatible domains, supported languages, timezones, and countries. All endpoints are publicly accessible without authentication.

## Get instance information

 - [GET /api/v1/instance](https://docs.wellesley.social/openapi/instance/paths/~1api~1v1~1instance/get.md): Returns comprehensive server instance metadata including domain, version, build information, registration configuration, and server rules. Useful for clients to understand server capabilities and requirements.

## Get country information

 - [GET /api/v1/instance/countries](https://docs.wellesley.social/openapi/instance/paths/~1api~1v1~1instance~1countries/get.md): Returns country data including names (common/official/native), flags, and phone codes. Data is cached in Redis with 7-day TTL and fetched from external API if not cached. Falls back to local file if API is unavailable. Used for country selection in user profiles and phone number validation.

## Search compatible federated domains

 - [GET /api/v1/instance/domains](https://docs.wellesley.social/openapi/instance/paths/~1api~1v1~1instance~1domains/get.md): Returns a list of federated server domains compatible with specified software. Filters domains by prefix matching for autocomplete functionality. Useful for discovering servers running specific ActivityPub software (Mastodon, Pleroma, etc.). Results are cached for performance.

## Get extended server description

 - [GET /api/v1/instance/extended_description](https://docs.wellesley.social/openapi/instance/paths/~1api~1v1~1instance~1extended_description/get.md): Returns detailed 'about' information for this server instance. Includes formatted HTML content describing the server's purpose and policies. Content is admin-configurable (feature pending implementation).

## Get supported languages

 - [GET /api/v1/instance/supported_languages](https://docs.wellesley.social/openapi/instance/paths/~1api~1v1~1instance~1supported_languages/get.md): Returns all languages supported by the platform for content and UI translation. Each language includes its ISO code and native name. Used for language selection in user preferences and content language detection. Languages are used by the translation API for multi-language support.

## Get supported timezones

 - [GET /api/v1/instance/timezones](https://docs.wellesley.social/openapi/instance/paths/~1api~1v1~1instance~1timezones/get.md): Returns a comprehensive list of all supported timezones with metadata. Includes timezone abbreviations, UTC offsets, DST information, and display text. Used for user timezone selection in profile settings.