# Price List Entries

# Create Price List Entry Endpoint

#### Structure

##### Price List Entry

<table border="1" id="bkmrk-name-type-descriptio" style="border-collapse: collapse; width: 100%; height: 737.907px;"><colgroup><col style="width: 25.0298%;"></col><col style="width: 25.0298%;"></col><col style="width: 25.0298%;"></col><col style="width: 25.0298%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Name**  
</td><td style="height: 29.7969px;">**Type**  
</td><td style="height: 29.7969px;">**Description**  
</td><td style="height: 29.7969px;">**Required**  
</td></tr><tr><td>`id`</td><td>int</td><td>The id for the entry</td><td>No</td></tr><tr><td>`for`</td><td>string</td><td>What the entry applies to (e.g., all\_products, all\_products\_unless\_reduced, product, variant, category, tag, manufacturer)</td><td>Yes</td></tr><tr><td>`target`</td><td>string</td><td>Identifier of the target (e.g., id corresponding to the `for` or model for product, or sku for variant or name for category/tag/manufacturer)</td><td>Conditional</td></tr><tr><td>`type`</td><td>string</td><td>Type of the price adjustment (e.g., fixed\_price, fixed\_price\_decrease, fixed\_price\_increase, percentage\_decrease, percentage\_increase)</td><td>Yes</td></tr><tr><td>`price`</td><td>object</td><td>The [Price](https://support.aerocommerce.com/books/api/page/create-price-list-entry-endpoint#bkmrk-price) object (not required when `type` is *percentage* based)</td><td>Conditional</td></tr><tr><td>`percentage`</td><td>float</td><td>The percentage of the price list entry (only required when `type` is *percentage* based)</td><td>Conditional</td></tr><tr><td>`for_price`</td><td>string</td><td>Which price the entry affects (e.g., sale\_price, base\_price, rrp, cost\_price)</td><td>Yes</td></tr></tbody></table>

##### Price

<table border="1" id="bkmrk-name-type-descriptio-1" style="border-collapse: collapse; width: 100%; height: 737.907px;"><colgroup><col style="width: 25.0298%;"></col><col style="width: 25.0298%;"></col><col style="width: 25.0298%;"></col><col style="width: 25.0298%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Name**  
</td><td style="height: 29.7969px;">**Type**  
</td><td style="height: 29.7969px;">**Description**  
</td><td style="height: 29.7969px;">**Required**  
</td></tr><tr><td>`amount`</td><td>float</td><td>The price **including tax**, in whole units (e.g. pounds not pence)</td><td>Yes</td></tr><tr><td>`currency`</td><td>string</td><td>The currency for the price, e.g. GBP</td><td>Yes</td></tr></tbody></table>

#### Example Request

```
POST /api/price-lists/{id}/entries
```

```json
{
    "for": "variant",
    "target": "sku",
    "type": "percentage_decrease",
    "percentage": 20,
    "for_price": "base_price"
}
```

#### Example Response

```json
{
    "priceListEntry": {
        "id": 1
    }
}
```

# Update Price List Entry Endpoint

#### Structure

##### Price List Entry

<table border="1" id="bkmrk-name-type-descriptio" style="border-collapse: collapse; width: 100%; height: 737.907px;"><colgroup><col style="width: 25.0298%;"></col><col style="width: 25.0298%;"></col><col style="width: 25.0298%;"></col><col style="width: 25.0298%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Name**  
</td><td style="height: 29.7969px;">**Type**  
</td><td style="height: 29.7969px;">**Description**  
</td><td style="height: 29.7969px;">**Required**  
</td></tr><tr><td>`id`</td><td>int</td><td>The id for the entry</td><td>No</td></tr><tr><td>`for`</td><td>string</td><td>What the entry applies to (e.g., all\_products, all\_products\_unless\_reduced, product, variant, category, tag, manufacturer)</td><td>No</td></tr><tr><td>`target`</td><td>string</td><td>Identifier of the target (e.g., id corresponding to the `for` or model for product, or sku for variant or name for category/tag/manufacturer)</td><td>No</td></tr><tr><td>`type`</td><td>string</td><td>Type of the price adjustment (e.g., fixed\_price, fixed\_price\_decrease, fixed\_price\_increase, percentage\_decrease, percentage\_increase)</td><td>No</td></tr><tr><td>`price`</td><td>object</td><td>The [Price](https://support.aerocommerce.com/books/api/page/create-price-list-entry-endpoint#bkmrk-price) object (not when `type` is *percentage* based)</td><td>No</td></tr><tr><td>`percentage`</td><td>float</td><td>The percentage of the price list entry (only when `type` is *percentage* based)</td><td>No</td></tr><tr><td>`for_price`</td><td>string</td><td>Which price the entry affects (e.g., sale\_price, base\_price, rrp, cost\_price)</td><td>No</td></tr></tbody></table>

##### Price

<table border="1" id="bkmrk-name-type-descriptio-1" style="border-collapse: collapse; width: 100%; height: 737.907px;"><colgroup><col style="width: 25.0298%;"></col><col style="width: 25.0298%;"></col><col style="width: 25.0298%;"></col><col style="width: 25.0298%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Name**  
</td><td style="height: 29.7969px;">**Type**  
</td><td style="height: 29.7969px;">**Description**  
</td><td style="height: 29.7969px;">**Required**  
</td></tr><tr><td>`amount`</td><td>float</td><td>The price **including tax**, in whole units (e.g. pounds not pence)</td><td>Yes</td></tr><tr><td>`currency`</td><td>string</td><td>The currency for the price, e.g. GBP</td><td>Yes</td></tr></tbody></table>

#### Example Request

```
PUT /api/price-lists/{id}/entries/{id}
```

```json
{
    "for": "product",
    "target": "model",
    "type": "percentage_decrease",
    "percentage": 20
}
```

#### Example Response

```json
{
    "priceListEntry": {
        "id": 1
    }
}
```