Create Batch of Price Lists Records
Creates a batch of Price Lists Records; may include price list records from more than one price list. Concurrency limit of 10, batch size of 100. Use PUT instead to update records that already exist.
Per-item validation failures — items referencing an unknown price list, unresolved variant_id or sku, items missing price, and items that duplicate another item in the same request — are rejected individually; the remaining valid items are saved, and meta.saved_records reflects the saved count.
If any otherwise-valid item collides with an existing price record (same price_list_id + variant + currency), the entire batch is rolled back. meta.saved_records returns 0, and the response identifies both the conflicting items and the items that would have been saved so you can fix the conflicts and resend the rest. See the 422 response for details.
Authentication
OAuth scopes
Authentication header
Further reading
For example requests and more information about authenticating BigCommerce APIs, see Authentication and Example Requests.
For more about BigCommerce OAuth scopes, see our Guide to API Accounts.
For a list of API status codes, see API Status Codes.
Path parameters
Headers
The MIME type of the response body.
Request
The 3-letter country code with which this price record is associated.
The variant with which the price record is associated. Either variant_id or sku is required.
The SKU for the variant with which this price record is associated. Either sku or variant_id is required.
The list price for the variant mapped in a Price List. Overrides any existing or Catalog list price for the variant/product. If empty, the sale price will be treated as not being set on this variant.
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.
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.
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.
Response
Success response for batch POST of Price List Records.