> For the complete documentation index, see [llms.txt](https://docs.terragon.io/documents/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.terragon.io/documents/terragon-api-document/system.md).

# System

System settings and information

## System ping

> Simple endpoint to check API availability

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"System","description":"System settings and information"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[],"paths":{"/v1/ping":{"get":{"tags":["System"],"summary":"System ping","description":"Simple endpoint to check API availability","operationId":"systemPing","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"string"}}}}}}}}}
```

## Get system settings

> Retrieve system settings

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"System","description":"System settings and information"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/v1/setting":{"get":{"tags":["System"],"summary":"Get system settings","description":"Retrieve system settings","operationId":"getSystemSettings","responses":{"200":{"description":"System settings retrieved successfully","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}}}}
```

## Get system currencies

> Retrieve available system currencies

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"System","description":"System settings and information"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"Currency":{"type":"object","properties":{"code":{"type":"string","description":"Currency code"},"name":{"type":"string","description":"Currency name"},"symbol":{"type":"string","description":"Currency symbol"},"decimal_places":{"type":"integer","description":"Decimal places"},"type":{"type":"string","enum":["fiat","crypto"],"description":"Currency type"},"is_default":{"type":"boolean","description":"Whether this is the default currency"},"conversion_rate":{"type":"number","format":"float","description":"Conversion rate to base currency"}}}}},"paths":{"/v1/system-currencies":{"get":{"tags":["System"],"summary":"Get system currencies","description":"Retrieve available system currencies","operationId":"getSystemCurrencies","responses":{"200":{"description":"System currencies retrieved successfully","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Currency"}}}}}}}}}}
```

## Get system settings

> Retrieve system settings

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"System","description":"System settings and information"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/v1/settings":{"get":{"tags":["System"],"summary":"Get system settings","description":"Retrieve system settings","operationId":"getSettings","responses":{"200":{"description":"System settings retrieved successfully","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}}}}
```

## Get system currencies

> Retrieve available system currencies

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"System","description":"System settings and information"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"Currency":{"type":"object","properties":{"code":{"type":"string","description":"Currency code"},"name":{"type":"string","description":"Currency name"},"symbol":{"type":"string","description":"Currency symbol"},"decimal_places":{"type":"integer","description":"Decimal places"},"type":{"type":"string","enum":["fiat","crypto"],"description":"Currency type"},"is_default":{"type":"boolean","description":"Whether this is the default currency"},"conversion_rate":{"type":"number","format":"float","description":"Conversion rate to base currency"}}}}},"paths":{"/v1/currencies":{"get":{"tags":["System"],"summary":"Get system currencies","description":"Retrieve available system currencies","operationId":"getCurrencies","responses":{"200":{"description":"System currencies retrieved successfully","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Currency"}}}}}}}}}}
```

## Get system memos

> Retrieve system memos

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"System","description":"System settings and information"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/v1/memos":{"get":{"tags":["System"],"summary":"Get system memos","description":"Retrieve system memos","operationId":"getSystemMemos","responses":{"200":{"description":"System memos retrieved successfully","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}}}}}}}}}}}}
```

## Get system memo

> Retrieve a specific system memo

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"System","description":"System settings and information"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/v1/memos/{key}":{"get":{"tags":["System"],"summary":"Get system memo","description":"Retrieve a specific system memo","operationId":"getSystemMemo","parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"},"description":"Memo key"}],"responses":{"200":{"description":"System memo retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}}}}}}}}}}}
```

## Get exchange rates

> Retrieve current exchange rates

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"System","description":"System settings and information"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ExchangeRate":{"type":"object","properties":{"from_currency":{"type":"string","description":"Source currency code"},"to_currency":{"type":"string","description":"Target currency code"},"rate":{"type":"number","format":"float","description":"Exchange rate"},"last_updated":{"type":"string","format":"date-time","description":"Last rate update timestamp"}}}}},"paths":{"/v1/exchange-rates":{"get":{"tags":["System"],"summary":"Get exchange rates","description":"Retrieve current exchange rates","operationId":"getExchangeRates","responses":{"200":{"description":"Exchange rates retrieved successfully","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ExchangeRate"}}}}}}}}}}
```

## Get localization data

> Retrieve system localization data

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"System","description":"System settings and information"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/v1/localization":{"get":{"tags":["System"],"summary":"Get localization data","description":"Retrieve system localization data","operationId":"getLocalization","responses":{"200":{"description":"Localization data retrieved successfully","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"string","description":"Localized string"}}}}}}}}}}
```

## Get system status

> Retrieve current system status

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"System","description":"System settings and information"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"SystemStatus":{"type":"object","properties":{"status":{"type":"string","enum":["online","maintenance","offline"],"description":"System status"},"maintenance_start":{"type":"string","format":"date-time","description":"Maintenance start time"},"maintenance_end":{"type":"string","format":"date-time","description":"Maintenance end time"},"message":{"type":"string"}}}}},"paths":{"/v1/system-status":{"get":{"tags":["System"],"summary":"Get system status","description":"Retrieve current system status","operationId":"getSystemStatus","responses":{"200":{"description":"System status retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SystemStatus"}}}}}}}}}
```