Virto Commerce

Virto Commerce Returns API

Return management: search returns, read a return by id, create or update a return against an order, and read the quantities still available to return.

Documentation GitHub OpenAPI

Operations 5

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/return/search Search product returns · Return search returns #

Ask an LLM

“Which returns have been opened against a particular order?”

“How do I page through all the product returns in my Virto Commerce store?”

Tell an agent

Find all returns filed for order {orderId}.

Search returns matching {keyword}.

GET /api/return/{id} Get a return by its ID · Return get return by id #

Ask an LLM

“What status and resolution does a specific return have?”

“Can I see the line items on one return record?”

Tell an agent

Open return {id} and show its line items and status.

Get the resolution recorded on return {id}.

PUT /api/return Save or update a product return · Return update return #

Ask an LLM

“How do I change the status of an existing return?”

“Can I record a resolution on a customer's return?”

Tell an agent

Set the status of return {id} to {status}.

Record resolution {resolution} on return {id}.

DELETE /api/return Delete product returns · Return delete return #

Ask an LLM

“How do I remove return records I no longer need?”

“Can I delete several returns at once?”

Tell an agent destructive · confirm first

Delete the returns with IDs {ids}.

Remove return record {ids} permanently.

GET /api/return/available-quantities/{orderId} Check quantities still returnable on an order · Return get available quantities #

Ask an LLM

“How many units of each item on an order can still be returned?”

“What quantities are left available to return after earlier returns?”

Tell an agent

Show the quantities still available to return on order {orderId}.

Check what is left to return from order {orderId}.

Virto Commerce Returns API

Operations 5

Documentation

Specifications

SDKs

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification