Set Price List Record by Currency Code | BigCommerce Developer Center

Creates or updates a Price List Record using the currency code. Notes

Supports up to 40 simultaneous PUT requests. Running more than the allowed number of requests concurrently on the same store will result in a 429 status error, and your additional requests will fail.

Creates or updates a *Price List Record* using the currency code. **Notes** * Supports up to 40 simultaneous PUT requests. Running more than the allowed number of requests concurrently on the same store will result in a `429` status error, and your additional requests will fail.

Authentication

X-Auth-Tokenstring

OAuth scopes

UI Name	Permission	Parameter
Products	modify	`store_v2_products`
Products	read-only	`store_v2_products_read_only`

Authentication header

Header	Argument	Description
`X-Auth-Token`	`access_token`	For more about API accounts that generate `access_token`s, see our Guide to API Accounts.

### OAuth scopes | UI Name | Permission | Parameter | |:--------|:-----------|:----------| | Products | modify | `store_v2_products` | | Products | read-only | `store_v2_products_read_only` | ### Authentication header | Header | Argument | Description | |:-------|:---------|:------------| | `X-Auth-Token` | `access_token` | For more about API accounts that generate `access_token`s, see our [Guide to API Accounts](/developer/docs/overview/api-accounts#api-accounts). | ### Further reading For example requests and more information about authenticating BigCommerce APIs, see [Authentication and Example Requests](/developer/docs/overview/api-accounts#x-auth-token-header-example-requests). For more about BigCommerce OAuth scopes, see our [Guide to API Accounts](/developer/docs/overview/api-accounts#oauth-scopes). For a list of API status codes, see [API Status Codes](/developer/api-reference/rest/overview#rest-http-status-codes).

Path parameters

price_list_idintegerRequired

The ID of the Price List requested.

variant_idintegerRequired

ID of the variant on a product, or on an associated Price List Record.

currency_codestringRequiredformat: "ISO-4217"

The currency code associated with the price record being acted upon.

Request

Common Price Record properties.

pricedoubleOptional

The list price for the variant mapped in a Price List. Overrides any existing or Catalog list price for the variant/product.

sale_pricedoubleOptional

The sale price for the variant mapped in a Price List. Overrides any existing or Catalog sale price for the variant/product. If empty, the sale price will be treated as not being set on this variant.

retail_pricedoubleOptional

The retail price for the variant mapped in a Price List. Overrides any existing or Catalog retail price for the variant/product. If empty, the retail price will be treated as not being set on this variant.

map_pricedoubleOptional

The MAP (Minimum Advertised Price) for the variant mapped in a Price List. Overrides any existing or Catalog MAP price for the variant/product. If empty, the MAP price will be treated as not being set on this variant.

bulk_pricing_tierslist of objectsOptional

Response

dataobject

The Price Record object.

metaobject

Response metadata.

Errors

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error

1	import requests
2
3	url = "https://api.bigcommerce.com/stores/store_hash/v3/pricelists/1/records/1/currency_code"
4
5	payload = {}
6	headers = {
7	"X-Auth-Token": "<apiKey>",
8	"Content-Type": "application/json"
9	}
10
11	response = requests.put(url, json=payload, headers=headers)
12
13	print(response.json())

1	{
2	"data": {
3	"calculated_price": 10.99,
4	"date_created": "2022-09-18T13:18:15Z",
5	"date_modified": "2022-09-18T13:30:48Z",
6	"product_id": 185,
7	"price_list_id": 4,
8	"variant_id": 356,
9	"currency": "eur",
10	"price": 12.99,
11	"sale_price": 10.99,
12	"retail_price": 15.99,
13	"map_price": 17.99,
14	"bulk_pricing_tiers": [
15	{
16	"quantity_min": 5,
17	"quantity_max": 10,
18	"type": "percent",
19	"amount": 1
20	},
21	{
22	"quantity_min": 11,
23	"quantity_max": 20,
24	"type": "percent",
25	"amount": 2
26	}
27	]
28	},
29	"meta": {}
30	}