Product

The Product API endpoints allow fetching essential product related data such as pricing and stock levels.

Gets one or more Products by product reference

get

Query parameters

productReferencestringOptional

One or more product references of products / product variants to retrieve.

Example: {"value":"34dc4eaf-2800-4fac-899c-b5e6ca94850b"}

fieldsstringOptional

Limit the properties returned in the response

Example: {"value":" "}

expandstringOptional

Defines the properties that should be expanded in the response

Example: {"value":" "}

Header parameters

Api-KeystringRequired

API key specified through configuration to authorize access to the API.

StorestringRequired

The ID or the alias of the store

Example: {"value":"573b1f7f-dc4d-49bd-a5b3-7ae753e32307"}

Current-OrderstringOptional

The ID of the current order associated with the current session

Example: 615c83c3-326e-4c82-ba81-3dfa97b74e53

Billing-CountrystringOptional

The ID or alias of the session default billing country

Example: {"value":"51b5ccf6-57b9-4641-b407-25a817b737e6"}

Billing-RegionstringOptional

The ID or alias of the session default billing region

Example: {"value":"551be988-8fd3-4120-8b9f-38ece5585e92"}

Shipping-CountrystringOptional

The ID or alias of the session default shipping country

Example: {"value":"c232e18b-919a-4408-a6e5-fe3ab5ef7d54"}

Shipping-RegionstringOptional

The ID or alias of the session default shipping region

Example: {"value":"4a0e4875-b757-4945-bdc2-f7186dc67b4a"}

Tax-ClassstringOptional

The ID or alias of the session default tax class

Example: {"value":"e4dbac33-5b18-47f6-8795-1db15149888c"}

CurrencystringOptional

The ID or alias of the session currency

Example: {"value":"64301345-f64f-4d97-8eb6-329e1545e4b0"}

Accept-LanguagestringOptional

The ISO culture code of the current session culture

Example: en-US

Customer-ReferencestringOptional

The unique reference for the customer associated with the current session

Example: cust_627edc2c-9547-4f8a-b057-df3040f24dc2

Responses

200

OK

application/json

400

Bad Request

get

HTTPcURLJavaScriptPython

GET /umbraco/commerce/storefront/api/v1/products HTTP/1.1
Host: 
Api-Key: text
Store: text
Accept: */*

[
  {
    "productReference": "text",
    "sku": "text",
    "name": "text",
    "productVariantReference": "text",
    "imageUrl": "text",
    "price": {
      "currency": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "code": "text"
      },
      "withoutTax": 1,
      "tax": 1,
      "withTax": 1,
      "formatted": {
        "withoutTax": "text",
        "tax": "text",
        "withTax": "text"
      }
    },
    "stock": 1,
    "attributes": [
      {
        "name": {
          "alias": "text",
          "name": "text"
        },
        "value": {
          "alias": "text",
          "name": "text"
        }
      }
    ],
    "taxClass": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "alias": "text",
      "name": "text",
      "store": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "alias": "text",
        "name": "text",
        "defaultCountry": "[Circular Reference]",
        "defaultTaxClass": "[Circular Reference]",
        "baseCurrency": "[Circular Reference]",
        "pricesIncludeTax": true
      },
      "defaultTaxRate": 1,
      "defaultTaxCode": "text",
      "taxRate": 1,
      "taxCode": "text",
      "countryRegionTaxClasses": [
        {
          "store": "[Circular Reference]",
          "country": "[Circular Reference]",
          "region": "[Circular Reference]",
          "taxRate": 1,
          "taxCode": "text"
        }
      ]
    },
    "properties": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "isGiftCard": true
  }
]