# GetCurrencyRoundingRule

Retrieve a single currency rounding rule

`GET /api/v2/accounts/{accountId}/currencyroundingrules/{id}`

**API:** AvaTax API
**Tag:** CurrencyRoundingRules
**API Version:** v2
**Base URL:** https://sandbox-rest.avatax.com/
**Accepts:** `application/json`
**Authentication:** API Key (`Authorization` in header) or OAuth 2.0 or Basic (username + license key)

Source: https://developer.avalara.com/products/crossborder/api/methods/CurrencyRoundingRules/GetCurrencyRoundingRule/

## Description

Retrieves a single currency rounding rule identified by this URL.

### Security Policies

* This API requires one of the following user roles: AccountAdmin, AccountUser, AvaTaxOnlyAccountAdmin, AvaTaxOnlyAccountUser, AvaTaxOnlyCompanyAdmin, AvaTaxOnlyCompanyUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ECMAccountUser, ECMCompanyUser, ReturnsOnlyAccountAdmin, ReturnsOnlyAccountUser, ReturnsOnlyCompanyAdmin, ReturnsOnlyCompanyUser, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.

## Parameters

| Name | Type | In | Required | Description |
|---|---|---|---|---|
| `accountId` | integer | path | Yes | The ID of the account that owns this currency rounding rule. |
| `id` | integer | path | Yes | The unique ID number of the currency rounding rule to retrieve. |
| `X-Avalara-Client` | string | header | No | Identifies the software you are using to call this API.  For more information on the client header, see [Client Headers](https://developer.avalara.com/avatax/client-headers/) . |

## Responses

| Status | Description | Schema |
|---|---|---|
| 200 | Success | `AccountCurrencyRoundingRuleModel` |
| 400 | Bad Request |  |
| 401 | Unauthorized |  |
| 404 | Not Found |  |

### 200 Response: `AccountCurrencyRoundingRuleModel`

A currency-rounding-rule model controls how AvaTax rounds calculated tax for a given
account and currency.
            
Each rule is effective-dated: it applies to transactions whose tax date falls within the
`effDate`/`endDate` window. When no account-specific rule applies for a currency on a
transaction's tax date, the tax engine uses standard decimal precision (no rounding).
            
An account may hold several rules for the same currency, and their windows may overlap: for a
given tax date the rule with the latest `effDate` whose window contains that date applies, so
adding a later-dated rule supersedes an earlier one. Two rules sharing a `currencyCode` and
`effDate` are ambiguous and are rejected.
            
A rule can only be created for a currency that already has an Avalara system default (see
the `ListCurrencyRoundingRuleDefaults` definitions API). The rounding method is fixed
(rounds halves away from zero) and is an internal implementation detail, not exposed here;
`precision` - `0` for the whole currency unit, or `2` for standard decimal cents - is the
only control over the rounding behavior.

| Property | Type | Required | Description |
|---|---|---|---|
| `id` | integer | No | A unique ID number representing this currency rounding rule. Example: `0`. |
| `accountId` | integer | No | The ID number of the account that owns this currency rounding rule. Example: `0`. |
| `currencyCode` | string | **Yes** | The three-character ISO 4217 currency code this rule applies to, for example `INR`, `TWD`, or `JPY`. Example: `INR`. |
| `precision` | integer | **Yes** | The number of decimal places the tax is rounded to: `0` for the whole currency unit, or
`2` for standard decimal cents. This is the only control over the rounding method. Example: `0`. |
| `effDate` | string | **Yes** | The first tax date, inclusive, for which this rule applies. Example: `2026-01-01T00:00:00`. |
| `endDate` | string | No | The last tax date, inclusive, for which this rule applies. If omitted, the rule applies
through `9998-12-31`; a later date is also stored as `9998-12-31`. Example: `9999-12-31T00:00:00`. |
| `createdDate` | string | No | The date when this record was created. |
| `createdUserId` | integer | No | The user ID of the user who created this record. |
| `modifiedDate` | string | No | The date/time when this record was last modified. |
| `modifiedUserId` | integer | No | The user ID of the user who last modified this record. |

## Example Request

```bash
curl -X GET "https://sandbox-rest.avatax.com/api/v2/accounts/{accountId}/currencyroundingrules/{id}" \
  -H "Authorization: Basic <credentials>" \
  -H "Accept: application/json"
```