# Setting the price of an item

When [describing items](/digital-river-api/integration-options/checkouts/creating-checkouts/describing-the-items.md) in a Checkout or Invoice, in addition to the required `skuId`parameter, you'll also need to define the [price](#defining-a-price) or [aggregate price](#defining-an-aggregate-price).

## Defining a price

In a `POST` Checkout or Invoice request, the `price` parameter represents the price of a single line item.

{% tabs %}
{% tab title="cURL" %}

```
curl --location --request POST 'https://api.digitalriver.com/checkouts' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <API_key>' \
--data-raw '{
    "customerId": 520984250336,
    ...
    "items": [
        {
            "skuId": "77817db3-5b74-443e-86fc-b04ee6637f29",
            "price": 100.00,
            "quantity": 2
        },
        {
            "skuId": "e446860d-86a6-4e22-ba38-bbaa2c17de55",
            "price": 50.00,
            "quantity": 3
        }
    ]
}'
```

{% endtab %}
{% endtabs %}

For each line item in the response, the `amount` returned is derived by multiplying the`price` and `quantity` supplied in the request.

{% tabs %}
{% tab title="JSON" %}

```javascript
{
    "id": "180144300336",
    ...
    "items": [
        {
            "skuId": "77817db3-5b74-443e-86fc-b04ee6637f29",
            "amount": 200.0,
            "quantity": 2,
            ...
        },
        {
            "skuId": "e446860d-86a6-4e22-ba38-bbaa2c17de55",
            "amount": 150.0,
            "quantity": 3,
            ...
        }
    ],
    ...
}
```

{% endtab %}
{% endtabs %}

## Defining an aggregate price

In a `POST` Checkout or Invoice request, the `aggregatePrice` parameter represents the total price of one or more items, regardless of the `quantity` you specify.

{% tabs %}
{% tab title="cURL" %}

```
curl --location --request POST 'https://api.digitalriver.com/checkouts' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <API_key>' \
--data-raw '{
    "customerId": 520984250336,
    ...
    "items": [
        {
            "skuId": "77817db3-5b74-443e-86fc-b04ee6637f29",
            "aggregatePrice": 100.00,
            "quantity": 2
        },
        {
            "skuId": "e446860d-86a6-4e22-ba38-bbaa2c17de55",
            "aggregatePrice": 50.00,
            "quantity": 3
        }
    ]
}'
```

{% endtab %}
{% endtabs %}

For each line item in the response, the `amount` returned is equal to the `aggregatePrice` you supplied in the request.

{% tabs %}
{% tab title="JSON" %}

```javascript
{
    "id": "180144320336",
    ...
    "items": [
        {
            "skuId": "77817db3-5b74-443e-86fc-b04ee6637f29",
            "amount": 100.0,
            "quantity": 2,
            ...
        },
        {
            "skuId": "e446860d-86a6-4e22-ba38-bbaa2c17de55",
            "amount": 50.0,
            "quantity": 3,
            ...
        }
    ],
    ...
}
```

{% endtab %}
{% endtabs %}

### Use cases

To better illustrate the aggregate price concept, the following examples provide use cases where the `aggregatePrice` parameter could be applied.

#### Example one

Let's say your website offers a price break when customers buy three or more laptop computers. This entices a shopper to purchase three laptops in one order. The customer is given a discounted price of $2,000 for the total order. That discounted price represents the `aggregatePrice`. The individual unit prices are now based on that `aggregatePrice`. So the effective price of each individual laptop is adjusted to approximately $667.67.

#### Example two

The `aggregatePrice` attribute can also be useful in buy one, get one (BOGO) free scenarios. You operate a grocery delivery service and your website has a BOGO offer on cases of soda. A customer purchases two cases and the offer is applied. The `aggregatePrice` is the cost of the first case of soda divided by two.


---

# 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/describing-the-items/price-of-an-item.md?ask=<question>
```

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.