Change your account's display currency

Change the primary currency displayed on your account, affecting how prices and invoices are shown. Requires `currencyId` from `GET /api/account/currency`.

Account & Settings Account

Context

Used in the dashboard

/cost-management /account

Workflow links

Requires

currency_id from GET /api/account/currency

Related endpoints

GET /api/account/currency Get account currency settings GET /api/account/stats Get account statistics and overview POST /api/account/update Update customer details on your account

Headers

Accept Example

Content-Type Example

Body

required

application/json

currencyId string required · Example: 2

Responses

200

data object required

data.currency object required

data.currency.code string · enum required · Example: EUR

Machine-readable error code.

EUR

USD

kr

data.currency.decimal string required · Example:

data.currency.enable string · Example: 1

data.currency.format string · enum required · Example: 1,234.56

1 234,56

1,234.56

data.currency.id string | integer required · Example: 2

data.currency.iso string · enum required · Example: EUR

EUR

SEK

USD

data.currency.last_changes string · Example: 2026-02-10 00:00:00

data.currency.rate string | integer · enum required · Example: 0.1000000000

0.1000000000

0.1166670000

data.currency.rounding string required · Example: 2

data.currency.rounding_mode string · Example: HALF_UP

data.currency.sign string · enum required · Example: €

$

€

data.currency.update string · Example: 0

data.currencyId string required · Example: 2

data.message string required · Example: Currency updated

Human-readable message.

data.pricingRecalcJobId string required · Example: recalculate_client_pricing-8207-1769762308438

data.success boolean required · Example: true

True for successful responses.

requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

success boolean required · Example: true

True for successful responses.

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

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

For AI assistants

cURL

curl -X POST "https://cloud.hostup.se/api/account/currency" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "currencyId": "2"
  }'

Response

{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "success": true,
    "message": "Currency updated",
    "currencyId": "2",
    "currency": {
      "id": "2",
      "code": "EUR",
      "sign": "€",
      "iso": "EUR",
      "rate": "0.1000000000",
      "last_changes": "2026-02-10 00:00:00",
      "update": "0",
      "enable": "1",
      "format": "1,234.56",
      "decimal": "",
      "rounding": "2"
    },
    "pricingRecalcJobId": "recalculate_client_pricing-8207-1769762308438"
  }
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "object",
          "properties": {
            "code": {
              "type": "string",
              "description": "Machine-readable error code.",
              "enum": [
                "EUR",
                "USD",
                "kr"
              ]
            },
            "decimal": {
              "type": "string"
            },
            "enable": {
              "type": "string"
            },
            "format": {
              "type": "string",
              "enum": [
                "1 234,56",
                "1,234.56"
              ]
            },
            "id": {
              "type": "string | integer"
            },
            "iso": {
              "type": "string",
              "enum": [
                "EUR",
                "SEK",
                "USD"
              ]
            },
            "last_changes": {
              "type": "string"
            },
            "rate": {
              "type": "string | integer",
              "enum": [
                "0.1000000000",
                "0.1166670000"
              ]
            },
            "rounding": {
              "type": "string"
            },
            "rounding_mode": {
              "type": "string"
            },
            "sign": {
              "type": "string",
              "enum": [
                "",
                "$",
                "€"
              ]
            },
            "update": {
              "type": "string"
            }
          }
        },
        "currencyId": {
          "type": "string"
        },
        "message": {
          "type": "string",
          "description": "Human-readable message."
        },
        "pricingRecalcJobId": {
          "type": "string"
        },
        "success": {
          "type": "boolean",
          "description": "True for successful responses."
        }
      }
    },
    "requestId": {
      "type": "string",
      "description": "Unique request identifier (UUID)."
    },
    "success": {
      "type": "boolean",
      "description": "True for successful responses."
    },
    "timestamp": {
      "type": "string",
      "description": "ISO 8601 timestamp (UTC)."
    }
  }
}

Request Body Example 1

{
  "currencyId": "2"
}