Skip to main content

Get a Price Book by ID

GET 

https://euwest.api.elasticpath.com/pcm/pricebooks/:pricebookID

Retrieves the specified price book. To include prices in the response, append ?include=prices to the path.

Request

Path Parameters

    pricebookID stringrequired

    The unique identifier of a price book.

Query Parameters

    include string

    Possible values: [prices]

    To include product prices in a response, add include=prices.

Responses

The price book.

Schema
    data objectrequired

    A price book with the following attributes.

    idstringrequired

    A unique identifier of a price book.

    Example: 4c45e4ec-26e0-4043-86e4-c15b9cf985a7
    typestringrequired

    Always pricebook.

    Possible values: [pricebook]

    Default value: pricebook
    Example: pricebook
    attributes objectrequired
    external_refstringnullable

    A unique attribute that you could use to contain information from another company system, for example. The maximum length is 2048 characters.

    Example: an-external-ref
    descriptionstringnullable

    A brief description that outlines the purpose of a price book, for example, flash sale pricing or preferred customer pricing.

    Example: This is a test price book
    namestringnullablerequired

    The name of a price book. Price books must have a unique name

    Example: Standard Price Book
    created_atdate-timerequired

    The date and time when the price book was created.

    Example: 2020-09-22T09:00:00Z
    updated_atdate-timerequired

    The date and time when the price book was last updated.

    Example: 2020-09-22T09:00:00Z
    meta object
    ownerstringnullable

    The resource owner, either organization or store.

    Example: store
    links object

    Links are used to allow you to move between requests.

    selfurinullable

    Single entities use a self parameter with a link to that specific resource.

    Example: /pcm/pricebooks/4c45e4ec-26e0-4043-86e4-c15b9cf985a7
    included object[]
  • Array [
  • typestringrequired

    Possible values: [product-price]

    Default value: product-price
    Example: product-price
    pricebook_external_refstringnullable

    The unique attribute associated with the price book. This can be an external reference from a separate company system, for example. The maximum length is 2048 characters.

    Example: a-pricebook-external-ref
    attributes objectrequired
    currencies object

    A collection of one or more currencies objects that consists of the three-letter ISO code of the currencies associated with this price and the amount. This is the product's price.

    property name* amount

    The three-letter ISO code for the currency associated with this price.

    amountint64nullable

    The price in the lowest denomination for the specified currency. This is a product's list price.

    Example: 100
    includes_taxboolean

    Whether this price includes tax.

    Default value: false
    Example: false
    tiers object

    The price tier that an item is eligible for based on the quantity purchased. You cannot have conflicting tiers within the same currencies block.

    property name* tier-price

    The name of the tier, for example, Pencils.

    minimum_quantityint64nullable

    The minimum quantity of 1 or more defined for the specified price. If a minimum quantity is not specified, an error is returned.

    Example: 10
    amountint64nullable

    The price for each quantity.

    Example: 50
    skustringrequired

    The product SKU that the price belongs to.

    Possible values: non-empty

    Example: product-sku-a
    sales object

    The sales price that an item is eligible for based on the price book.

    property name* sale

    The name of the sale, such as Summer Sale.

    bundle_idsuuid[]

    A list of product IDs in a bundle that you want to specify a sale price for.

    schedule objectnullable

    The schedule of the sale. Contains an optional valid_from and valid_to parameter for the start and end date of a sale.

    For sale prices in the same price book:

    • the schedules must not be exactly the same.
    • schedules can partially overlap. If the schedule does contain overlapping sales prices, the sale price of the smallest sale period is chosen.
    • if you have just one sale price, without a schedule, this is effectively a permanent price. If you want to add more sale prices to the price book, you must configure a schedule for the sale price.

    Sale prices in different price books can have overlapping schedules.

    valid_fromdate-timenullable

    The start date of the sale.

    Example: 2023-09-22T09:00:00Z
    valid_todate-timenullable

    The end date of the sale.

    Example: 2023-09-24T09:00:00Z
    currencies object

    A collection of one or more currencies objects that consists of the three-letter ISO code of the currencies associated with this price and the amount. This is the product's price.

    property name* amount

    The three-letter ISO code for the currency associated with this price.

    amountint64nullable

    The price in the lowest denomination for the specified currency. This is a product's list price.

    Example: 100
    includes_taxboolean

    Whether this price includes tax.

    Default value: false
    Example: false
    tiers object

    The price tier that an item is eligible for based on the quantity purchased. You cannot have conflicting tiers within the same currencies block.

    property name* tier-price

    The name of the tier, for example, Pencils.

    minimum_quantityint64nullable

    The minimum quantity of 1 or more defined for the specified price. If a minimum quantity is not specified, an error is returned.

    Example: 10
    amountint64nullable

    The price for each quantity.

    Example: 50
    external_refstringnullable

    A unique attribute that you could use to contain information from another company system, for example. The maximum length is 2048 characters.

    Example: external-ref
    created_atdate-time

    The date and time when the price was created.

    Example: 2020-09-22T09:00:00Z
    updated_atdate-time

    The date and time when the price was last updated.

    Example: 2020-09-22T09:00:00Z
    admin_attributes object

    You can add custom attributes to a product price. For example, you may want to add custom attributes that can automate price updates based on predefined rules, saving time and reducing human error or you might want to integrate price attributes with your other company systems, (ERP, CRM) ensuring consistency and accuracy across platforms.

    admin_attributes are not displayed in catalogs. This means admin_attributes can only be viewed by administrators. If you want a custom attribute to be displayed in a catalog, you must add a shopper_attribute.

    admin_attributes are structured as key-value pairs. Both the keys and values are strings. You can have up to 100 keys.

    property name*stringnullable
    shopper_attributes object

    You can add custom attributes to a product price. For example, you can set prices based on customer segments. For instance, you can offer different prices for wholesale and retail customers or provide discounts to loyal customers. Following on from this, you might want to offer personalized offers and prices, enhancing the shopping experience.

    shopper_attributes are displayed in catalogs. This means shopper_attributes can be viewed by both shoppers and administrators. If you do not want a custom attribute to be displayed in a catalog, you must add an admin_attribute.

    shopper_attributes are structured as key-value pairs. Both the keys and values are strings. You can have up to 100 keys.

    property name*stringnullable
    idstringrequired

    The unique identifier for the product price.

    Example: a915553d-935d-4d56-870b-817b47a44a99
    meta object

    Information that provides context to other data sets.

    ownerstringnullable

    The resource owner, either organization or store.

    Example: store
    pricebook_idstring

    The unique identifier of the price book.

    Example: 4c45e4ec-26e0-4043-86e4-c15b9cf985a7
  • ]

Authorization: Authorization

name: Authorizationtype: httpin: headerscheme: bearer
var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://euwest.api.elasticpath.com/pcm/pricebooks/:pricebookID");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer <Authorization>");
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
Request Collapse all
Base URL
https://euwest.api.elasticpath.com
Auth
Parameters
— pathrequired
— query
ResponseClear

Click the Send API Request button above and see the response here!