# Update Country Settings

> Solarium docs, Country & Tax Setup. All requests are `POST https://api.trysolarium.com/graphql/` with `Authorization: Bearer <api key>` and a JSON body `{"query": ..., "variables": ...}`. Every query and mutation takes an `organizationId` (find it with `myOrganizations`). Index of all pages: https://trysolarium.com/llms.txt

For an organization outside Canada: its region, tax registration number, and either its own sales tax rates (generic countries) or its business type (US). The currency (generic countries) and the business type (US) can only change before any transactions are booked. Changing the business type re-codes every account to the new form's lines. Requires the owner or admin role. A Canadian organization's province and filing frequency are set with updateOrganization.

### Arguments

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `organizationId` | `UUID!` | Yes | Organization ID |
| `region` | `String` | No | US: a state code. Elsewhere: free text |
| `currency` | `String` | No | Generic countries, before any transactions |
| `taxRates` | `[TaxRateInput!]` | No | Generic countries: replaces the rates. Each has name, ratePercent and recoverable (tax paid on purchases is claimed back) |
| `registrationNumber` | `String` | No | Sales tax registration number |
| `businessType` | `String` | No | US, before any transactions: sch_c, 1065, 1120 or 1120s |

### Request

```graphql
mutation {
  updateJurisdiction(
    organizationId: "a1b2c3d4-..."
    taxRates: [
      { name: "VAT", ratePercent: "20", recoverable: true }
      { name: "Reduced VAT", ratePercent: "5", recoverable: true }
    ]
  ) {
    success
    error
    jurisdiction { currency taxRates { code name ratePercent recoverable } }
  }
}
```

### Response

```json
{
  "data": {
    "updateJurisdiction": {
      "success": true,
      "error": null,
      "jurisdiction": {
        "currency": "GBP",
        "taxRates": [
          { "code": "vat", "name": "VAT", "ratePercent": "20", "recoverable": true },
          { "code": "reduced_vat", "name": "Reduced VAT", "ratePercent": "5", "recoverable": true }
        ]
      }
    }
  }
}
```