# Accessing regulatory fee information
When [regulatory fees are applied to products](/digital-river-api/product-management/regulatory-fees/managing-regulatory-fees.md) in a transaction, you can access both [aggregated](#determining-the-aggregated-fee-amount) and [product-level](#getting-information-on-specific-fees) information on these fees. This allows you to provide customers transparency into the transaction's fee types, their costs, and which products the fees apply to.
## Getting the aggregated fee amounts
You can find their aggregated amount in the `totalFees` attribute for transactions with one or more assessed [regulatory fees](/digital-river-api/product-management/regulatory-fees.md). This attribute is contained in the [checkout](https://docs.digitalriver.com/digital-river-api-reference/2021-12-13/checkouts), [order](https://docs.digitalriver.com/digital-river-api-reference/2021-12-13/orders), and [invoice ](https://docs.digitalriver.com/digital-river-api-reference/2021-12-13/invoices)resources. The `totalFees` value does *not* include taxes assessed on a transaction's regulatory fees. Instead, fee taxes are rolled up into the `totalTax` value.
{% tabs %}
{% tab title="Checkout" %}
```javascript
{
"id": "4f434b0f-b3b6-4698-8754-becb034f1abd",
...
"totalAmount": 44.09,
"subtotal": 41.0,
"totalFees": 16.0,
"totalTax": 3.09,
...
"items": [
{
"id": "f8c25de3-ddba-4a41-9946-3db9801bb04f",
...
"amount": 20.0,
"quantity": 2,
...
"fees": {
...
"amount": 16.0,
"taxAmount": 1.2
}
}
],
...
}
```
{% endtab %}
{% endtabs %}
For each line item with applied regulatory fees, we return `fees.amount`. This represents the amount of fees applied to the total `quantity` of that particular line item. For example, if the line item consists of two mobile phones, `fees.amount` is the aggregated fee amount applied to both devices. The `fees.taxAmount` represents taxes assessed on these line item fees.
## Getting information on specific fees
If you [associate regulatory fees with a SKU](/digital-river-api/product-management/regulatory-fees/managing-regulatory-fees.md#sku-identifier) and [add that SKU to a checkout](/digital-river-api/integration-options/checkouts/creating-checkouts/describing-the-items.md), we return information on each applied fee. In [checkout](https://docs.digitalriver.com/digital-river-api-reference/2021-12-13/checkouts), [order](https://docs.digitalriver.com/digital-river-api-reference/2021-12-13/orders), and [invoice](https://docs.digitalriver.com/digital-river-api-reference/2021-12-13/invoices), this information is contained within `items[].fees.details[]`.
The data in this array is useful when multiple regulatory fees are associated with a SKU. Each element in the array provides a fee's unique `id`, the [fee `type`](/digital-river-api/product-management/regulatory-fees/managing-regulatory-fees.md#type), the `perUnitAmount`, and the `amount`. The following table shows how some of these attributes are mapped within the [Fee](https://docs.digitalriver.com/digital-river-api-reference/2021-12-13/fees), Checkout, and Order resources.
| `Fee` | | `Checkout` | | `Order` |
| -------- | ----- | -------------------------------------- | ----- | -------------------------------------- |
| `id` | **➔** | `items[].fees.details[].id` | **➔** | `items[].fees.details[].id` |
| `type` | **➔** | `items[].fees.details[].type` | **➔** | `items[].fees.details[].type` |
| `amount` | **➔** | `items[].fees.details[].perUnitAmount` | **➔** | `items[].fees.details[].perUnitAmount` |
The same relationship exists between Fees and Invoices:
| `Fee` | | `Invoice` |
| -------- | ----- | -------------------------------------- |
| `id` | **➔** | `items[].fees.details[].id` |
| `type` | **➔** | `items[].fees.details[].type` |
| `amount` | **➔** | `items[].fees.details[].perUnitAmount` |
The `details[].amount` is determined by multiplying `details[].perUnitAmount` by the `quantity` of that line item.
In the following example, a physical SKU is created and associated with two separate regulatory fees. The first is a [battery type fee](/digital-river-api/product-management/regulatory-fees/managing-regulatory-fees.md#battery) with an `amount` of `5.0`. The second is a [WEEE type fee](/digital-river-api/product-management/regulatory-fees/managing-regulatory-fees.md#weee) with an `amount` of `3.0`.
The SKU is then attached to a checkout. Since there are now two regulatory fees associated with this checkout's sole line item, `details[]` contains two elements. Each element maps to one of the applied regulatory fees. When the [checkout is converted to an order](/digital-river-api/order-management/creating-and-updating-an-order.md#creating-an-order-with-the-checkout-identifier), the returned fees data remains the same.
You can use this information to provide customers with detailed regulatory fee information. In the example below, you could inform customers that both a [battery](/digital-river-api/product-management/regulatory-fees/managing-regulatory-fees.md#battery) and [WEEE](/digital-river-api/product-management/regulatory-fees/managing-regulatory-fees.md#weee) regulatory fee are applied to the product and provide a cost breakdown for each.
{% tabs %}
{% tab title="SKU " %}
```javascript
{
"id": "8639a055-ce57-4e1d-afdd-bf83769c3d21",
"createdTime": "2021-04-08T15:36:04Z",
...
"physical": true
}
```
{% endtab %}
{% tab title="Battery Fee associated w/ SKU" %}
```javascript
{
"id": "fee_09eefe18-3352-45b8-b1b7-8f15cad3be5b",
"skuId": "8639a055-ce57-4e1d-afdd-bf83769c3d21",
...
"amount": 5.0,
...
"createdTime": "2021-04-08T15:38:20Z",
...
"type": "battery"
}
```
{% endtab %}
{% tab title="WEEE Fee associated w/ SKU" %}
```javascript
{
"id": "fee_76828e24-67ed-46e3-9741-362b9e5e3aed",
"skuId": "8639a055-ce57-4e1d-afdd-bf83769c3d21",
...
"amount": 3.0,
...
"createdTime": "2021-04-08T15:38:33Z",
...
"type": "weee"
}
```
{% endtab %}
{% tab title="Checkout w/attached SKU" %}
```javascript
{
"id": "4f434b0f-b3b6-4698-8754-becb034f1abd",
"createdTime": "2021-04-08T15:39:22Z",
...
"totalAmount": 44.09,
...
"totalFees": 16.0,
...
"items": [
{
"id": "f8c25de3-ddba-4a41-9946-3db9801bb04f",
"skuId": "8639a055-ce57-4e1d-afdd-bf83769c3d21",
"amount": 20.0,
"quantity": 2,
...
"fees": {
"details": [
{
"type": "weee",
"perUnitAmount": 3.0,
"amount": 6.0,
"id": "fee_76828e24-67ed-46e3-9741-362b9e5e3aed"
},
{
"type": "battery",
"perUnitAmount": 5.0,
"amount": 10.0,
"id": "fee_09eefe18-3352-45b8-b1b7-8f15cad3be5b"
}
],
"amount": 16.0,
"taxAmount": 1.2
}
}
],
...
}
```
{% endtab %}
{% tab title="Order" %}
```javascript
{
"id": "187279700336",
"createdTime": "2021-04-08T15:40:32Z",
...
"totalAmount": 44.09,
...
"totalFees": 16.0,
...
"items": [
{
"id": "108649890336",
"skuId": "8639a055-ce57-4e1d-afdd-bf83769c3d21",
"amount": 20.0,
"quantity": 2,
...
"fees": {
"details": [
{
"type": "weee",
"perUnitAmount": 3.0,
"amount": 6.0,
"id": "fee_76828e24-67ed-46e3-9741-362b9e5e3aed"
},
{
"type": "battery",
"perUnitAmount": 5.0,
"amount": 10.0,
"id": "fee_09eefe18-3352-45b8-b1b7-8f15cad3be5b"
}
],
"amount": 16.0,
"taxAmount": 1.2
}
}
],
...
"checkoutId": "4f434b0f-b3b6-4698-8754-becb034f1abd"
}
```
{% endtab %}
{% endtabs %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.digitalriver.com/digital-river-api/integration-options/checkouts/creating-checkouts/accessing-regulatory-fee-information.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.