Get and change account currency settings

View the current currency for your account and available currencies. The response includes an ID for the current currency, which may be needed for other API calls, such as invoicing or service management. You can also change your account currency.

Headers

Accept Example

Content-Type Example

Responses

200

success boolean

timestamp string

requestId string

data object

GET https://cloud.hostup.se/api/account/currency

For AI assistants

cURL

curl -X GET "https://cloud.hostup.se/api/account/currency" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "success": true,
  "timestamp": "string",
  "requestId": "string",
  "data": {
    "success": true,
    "currentCurrencyId": "string",
    "currentCurrency": {
      "id": "string",
      "code": "string",
      "sign": "string",
      "iso": "string",
      "rate": "string",
      "last_changes": "string",
      "update": "string",
      "enable": "string",
      "format": "string",
      "decimal": "string",
      "rounding": "string"
    },
    "currencies": [
      {
        "code": "string",
        "iso": "string",
        "sign": "string",
        "format": "string",
        "decimal": "string",
        "rounding": "string",
        "rounding_mode": "string",
        "id": "string",
        "rate": 0
      }
    ],
    "canChangeCurrency": true,
    "unpaidInvoiceCount": 0,
    "changeLimit": {
      "used": 0,
      "limit": 0,
      "remaining": 0,
      "nextReset": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "timestamp": {
      "type": "string"
    },
    "requestId": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean"
        },
        "currentCurrencyId": {
          "type": "string"
        },
        "currentCurrency": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "code": {
              "type": "string"
            },
            "sign": {
              "type": "string"
            },
            "iso": {
              "type": "string"
            },
            "rate": {
              "type": "string"
            },
            "last_changes": {
              "type": "string"
            },
            "update": {
              "type": "string"
            },
            "enable": {
              "type": "string"
            },
            "format": {
              "type": "string"
            },
            "decimal": {
              "type": "string"
            },
            "rounding": {
              "type": "string"
            }
          }
        },
        "currencies": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "iso": {
                "type": "string"
              },
              "sign": {
                "type": "string"
              },
              "format": {
                "type": "string"
              },
              "decimal": {
                "type": "string"
              },
              "rounding": {
                "type": "string"
              },
              "rounding_mode": {
                "type": "string"
              },
              "id": {
                "type": "string"
              },
              "rate": {
                "type": "integer"
              }
            }
          }
        },
        "canChangeCurrency": {
          "type": "boolean"
        },
        "unpaidInvoiceCount": {
          "type": "integer"
        },
        "changeLimit": {
          "type": "object",
          "properties": {
            "used": {
              "type": "integer"
            },
            "limit": {
              "type": "integer"
            },
            "remaining": {
              "type": "integer"
            },
            "nextReset": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}