Virto Commerce

Virto Commerce Pricing API

Robust pricing management functionality based on price list and dynamic evaluation

GitHub OpenAPI
Business capability
Price List Management BC-440.20

Operations 32

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /api/pricing/evaluate Evaluate product prices for a shopping context · Evaluate prices by given context #
Ask an LLM
“What price would a specific customer pay for these products in my store?”
“Can price evaluation take quantity, currency and the shopper's location into account?”
Tell an agent
Evaluate prices for products {productIds} in store {storeId}.
Work out the price of {productIds} for customer {customerId} at quantity {quantity} in {currency}.
POST /api/pricing/pricelists/evaluate Evaluate which price lists apply to a context · Evaluate pricelists by given context #
Ask an LLM
“Which price lists apply to a given store, customer and currency right now?”
“Can I find out which price lists would be used for a shopper on a certain date?”
Tell an agent
Evaluate which price lists apply in store {storeId} for currency {currency}.
Tell me the price lists that apply to customer {customerId} on {date}.
GET /api/pricing/assignments/{id} Get a price list assignment · Get pricelist assignment #
Ask an LLM
“Which catalog or store is a given price list assignment tied to?”
“How do I view the conditions and dates on one price list assignment?”
Tell an agent
Show price list assignment {id}.
Get the start and end dates for price list assignment {id}.
PATCH /api/pricing/assignments/{id} Partially update a price list assignment · Partial update for the specified pricelist assignment by id #
Ask an LLM
“Can I change only the priority of a price list assignment?”
“Is there a JSON Patch option for editing price list assignments?”
Tell an agent
Patch price list assignment {id} with only the changed fields.
Apply a partial update to assignment {id}.
GET /api/pricing/assignments/outer/{outerId} Get a price list assignment by external id · Get pricelist assignment by outer id #
Ask an LLM
“How can I find a price list assignment using my ERP's key?”
“Can I look up an assignment by outer id instead of its internal id?”
Tell an agent
Get the price list assignment with outer id {outerId}.
Look up assignment by integration key {outerId}.
GET /api/pricing/assignments/new Get a blank price list assignment template · Get a new pricelist assignment #
Ask an LLM
“What does an empty price list assignment object look like before I save it?”
“Can I get a new assignment template without creating anything?”
Tell an agent
Give me a new unsaved price list assignment template.
Fetch a blank assignment object to fill in.
GET /api/pricing/pricelists Search price lists · Get pricelists #
Ask an LLM
“Which price lists do I have across all catalogs?”
“Can I list only the price lists in a particular currency?”
Tell an agent
List price lists in currency {currencies}.
Search price lists matching {keyword}.
POST /api/pricing/pricelists Create a price list · Create pricelist #
Ask an LLM
“How do I set up a new price list for a currency?”
“Can a new price list be created with its prices and assignments included?”
Tell an agent
Create a price list called {name} in {currency}.
Add a new price list {name} with priority {priority}.
PUT /api/pricing/pricelists Update a price list · Update pricelist #
Ask an LLM
“How do I change the priority or currency of an existing price list?”
“Can I replace a whole price list's details and prices in one request?”
Tell an agent
Update price list {id} to priority {priority}.
Rename existing price list {id} to {name}.
DELETE /api/pricing/pricelists Delete price lists · Delete pricelists #
Ask an LLM
“Can I delete several price lists in one go?”
“What is needed to remove a price list permanently?”
Tell an agent destructive · confirm first
Delete price lists {ids}.
Remove the price list {ids}.
GET /api/pricing/assignments Search price list assignments · Search pricelist assignments #
Ask an LLM
“Which stores and catalogs is a given price list assigned to?”
“Can I list all price list assignments for one store?”
Tell an agent
Find assignments for price list {priceListId}.
List price list assignments in stores {storeIds}.
POST /api/pricing/assignments Assign a price list to a store or catalog · Create pricelist assignment #
Ask an LLM
“How do I make a price list apply in a specific store?”
“Can I schedule a price list to apply only between two dates?”
Tell an agent
Assign price list {pricelistId} to store {storeId}.
Create an assignment of price list {pricelistId} to catalog {catalogId} starting {start}.
PUT /api/pricing/assignments Update a price list assignment · Update pricelist assignment #
Ask an LLM
“How do I change the dates on an existing price list assignment?”
“Can I move an assignment to a different store?”
Tell an agent
Update assignment {id} to run from {start} to {end}.
Move existing assignment {id} to store {storeId}.
DELETE /api/pricing/assignments Delete price list assignments by id · Delete pricelist assignments #
Ask an LLM
“Can I remove specific price list assignments when I know their ids?”
“What stops a price list from applying to a store I assigned it to?”
Tell an agent destructive · confirm first
Delete price list assignments {ids}.
Remove assignment {ids} by its id.
GET /api/catalog/products/prices/search Search product prices with query parameters · Search product prices #
Ask an LLM
“What prices does a product have across my price lists?”
“Can I find prices modified since a date using a simple GET with query parameters?”
Tell an agent
Search prices for product {productId} using the GET query form.
List prices in price list {priceListId} changed since {since} via query string.
POST /api/catalog/products/prices/search Search product prices with a request body · Search product prices #
Ask an LLM
“Can I search prices for many products at once by posting the criteria?”
“Is there a way to group price search results by product?”
Tell an agent
Post a price search for products {productIds} grouped by product.
Search prices in price lists {priceListIds} using a request body.
GET /api/products/{productId}/prices Get a product's valid prices per currency · Evaluate product prices #
Ask an LLM
“What is a product's current price in each currency?”
“Which prices are valid for one product right now?”
Tell an agent
Show the valid prices for product {productId} in every currency.
Evaluate current prices of product {productId}.
PUT /api/products/{productId}/prices Update one product's prices · Update product prices #
Ask an LLM
“How do I replace the prices for a single product?”
“Can I set a product's list and sale prices in one call?”
Tell an agent
Update the prices of product {productId} to {prices}.
Set new prices on product {productId}.
GET /api/products/{productId}/{catalogId}/pricesWidget Get a product's prices within a catalog · Evaluate product prices for demand catalog #
Ask an LLM
“What prices does a product have in a specific virtual catalog?”
“Can I evaluate a product's prices for the price widget of one catalog?”
Tell an agent
Show prices for product {productId} in catalog {catalogId}.
Evaluate the catalog-specific prices of {productId} for catalog {catalogId}.
PUT /api/products/prices Update prices for many products · Update product prices #
Ask an LLM
“Can I bulk update prices for several products in one request?”
“Which call lets me push a whole batch of product prices?”
Tell an agent
Bulk update prices for multiple products.
Save this batch of product prices across several products.
GET /api/catalog/products/{productId}/pricelists List price lists containing a product · Get all price lists for product #
Ask an LLM
“Which price lists include a given product?”
“In how many price lists does this product appear?”
Tell an agent
List all price lists for product {productId}.
Show which price lists product {productId} belongs to.
GET /api/pricing/pricelists/{id} Get a price list with its assignments · Get pricelist #
Ask an LLM
“What prices and assignments are in a specific price list?”
“How do I load a full price list by its id?”
Tell an agent
Get price list {id} with its assignments.
Show the full details of price list {id}.
PATCH /api/pricing/pricelists/{id} Partially update a price list · Partial update for the specified Pricelist by id #
Ask an LLM
“Can I patch a single field on a price list, like its description?”
“Is JSON Patch supported for price lists?”
Tell an agent
Patch price list {id} with just the changed fields.
Apply a partial update to price list {id}.
GET /api/pricing/pricelists/outer/{outerId} Get a price list by external id · Get pricelist by outer id #
Ask an LLM
“How do I find a price list from my ERP's integration key?”
“Can I fetch a full price list by outer id?”
Tell an agent
Fetch the full price list whose ERP key is {outerId}.
Look up the full price list for integration key {outerId}.
GET /api/pricing/pricelistsshort/{id} Get a price list without its assignments · Get pricelist in short mode (without assignments to avoid redundant assignments… #
Ask an LLM
“Can I load a price list quickly without pulling all its assignments?”
“Is there a lightweight view of a price list by id?”
Tell an agent
Get price list {id} in short mode without assignments.
Show the lightweight version of price list {id}.
GET /api/pricing/pricelistsshort/outer/{outerId} Get a short price list by external id · Get pricelist by outer id in short mode (without assignments) #
Ask an LLM
“Can I get a price list by outer id but skip its assignments?”
“What is the lightest way to look up a price list from my ERP key?”
Tell an agent
Get the short price list for outer id {outerId}.
Fetch price list {outerId} by integration key without assignments.
DELETE /api/pricing/filteredAssignments Delete price list assignments matching criteria · Delete pricelist assignments #
Ask an LLM
“Can I delete every assignment of a price list without listing their ids?”
“Is there a way to remove all price list assignments for certain stores?”
Tell an agent destructive · confirm first
Delete all assignments of price list {priceListId}.
Remove every price list assignment for stores {storeIds}.
DELETE /api/pricing/pricelists/{pricelistId}/products/prices Delete a product's prices from a price list · Delete all prices for specified product in specified price list #
Ask an LLM
“How do I remove all prices for certain products from one price list?”
“Can I clear a product out of a price list entirely?”
Tell an agent destructive · confirm first
Delete all prices for products {productIds} in price list {pricelistId}.
Clear every product price from price list {pricelistId}.
DELETE /api/pricing/products/prices Delete prices by price id · Delete price by ids #
Ask an LLM
“Can I delete individual price records when I know their ids?”
“What removes one specific price entry?”
Tell an agent destructive · confirm first
Delete price records {priceIds}.
Remove the single price entry {priceIds}.
POST /api/pricing/mergedpricegroups Merge base and priority price lists by product · Merge base and priority price list and returns MergedPriceGroup #
Ask an LLM
“Which products end up with which price when a priority list overrides a base list?”
“Can I see merged price groups per product for two price lists?”
Tell an agent
Merge base price list {base} with priority list {priority} and group by product.
Show merged price groups for products {productIds}.
POST /api/pricing/mergedprices Get merged prices from base and priority lists · Merge base and priority price list and returns MergedPrice #
Ask an LLM
“What are the individual merged prices after combining a base and a priority price list?”
“Can I list each resulting price when one list overrides another?”
Tell an agent
List the merged prices of base list {base} overridden by {priority}.
Get individual merged price rows for products {productIds}.
PATCH /api/products/prices/{id} Partially update a product price · Partial update for the specified ProductPrice by id #
Ask an LLM
“Can I change just the sale price on one price record?”
“Is a single product price editable with JSON Patch?”
Tell an agent
Patch product price {id} with the changed fields.
Apply a partial update to price record {id}.

Documentation

📖
Documentation
https://docs.virtocommerce.org/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/virto-commerce/refs/heads/main/openapi/virto-commerce-pricing-api-openapi.yml

SDKs

📦
GitHubRepository
https://github.com/VirtoCommerce/vc-module-catalog
📦
GitHubRepository
https://github.com/VirtoCommerce/vc-module-pricing
📦
GitHubRepository
https://github.com/VirtoCommerce/vc-module-inventory
📦
GitHubRepository
https://github.com/VirtoCommerce/vc-module-order
📦
GitHubRepository
https://github.com/VirtoCommerce/vc-module-x-cart
📦
GitHubRepository
https://github.com/VirtoCommerce/vc-module-customer
📦
GitHubRepository
https://github.com/VirtoCommerce/vc-module-marketing
📦
GitHubRepository
https://github.com/VirtoCommerce/vc-module-quote
📦
GitHubRepository
https://github.com/VirtoCommerce/vc-module-store
📦
GitHubRepository
https://github.com/VirtoCommerce/vc-platform

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/virto-commerce/refs/heads/main/overlays/virto-commerce-pricing-api-overlay.yaml
🔗
GraphQL
https://raw.githubusercontent.com/api-evangelist/virto-commerce/refs/heads/main/graphql/virto-commerce-graphql.md

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/virto-commerce:virto-commerce-pricing-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

virto-commerce-pricing-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: VirtoCommerce. Pricing API
  version: v1
  description: Robust pricing management functionality based on price list and dynamic evaluation
tags:


# --- truncated at 32 KB (100 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/virto-commerce/refs/heads/main/openapi/virto-commerce-pricing-api-openapi.yml