Return lookup by barcode

A new Returns API lets you list return items and their barcode references for a given barcode across the merchants you operate, so your warehouse can identify an inbound return from the label alone.

Endpoint	Summary
POST /v1/return-references/list	ListReturnReferences — lists return items and their barcode references matching a barcode for the given merchants.

This is the first endpoint on the Returns service — a single RPC, scoped to the merchants your credentials cover.

Why you'd use it

A returned parcel arrives at your facility carrying a barcode. Scan it, call ListReturnReferences, and you get the return items associated with it across all your partner merchants in one response — enough to route the parcel without a manual reconciliation step.

The endpoint and its full schema are in the Returns section of the API reference.