noon_returns_ListReturnReferences
Look up the purchased items being returned that match a scanned barcode, across the merchants you can access, with every barcode reference on each — when a return arrives and you n
readnoonnoon
eed the SKU and purchase it belongs to. noon API · ReturnReferenceService_ListReturnReferences · POST /returns/v1/return-references/list Docs: https://noon-docs.noonpartners.dev/docs/api-reference/returns/return-reference-service-list-return-references
Call it
In an AI client (MCP)
{
"name": "noon_returns_ListReturnReferences",
"arguments": {
"store": "myStore-US",
"barcode": "<barcode>"
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/noon_returns_ListReturnReferences \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US","barcode":"<barcode>"}'Early access — the Tool API is open on request, contact us.
Arguments
| Name | Type | Description |
|---|---|---|
storerequired | string | the noon account ref `<account>-<CC>` (name-country, e.g. 'myNoon-AE') — one of get_user_context's noon store_refs, verbatim. |
barcoderequired | string | the barcode to look up (required). |
merchant_codes | object[] | optional merchant codes to scope the search to (at most 200, ones you can access); omit it to scope to the account's default project. |
Result
Every tool answers {notification, data, human_action}; data carries:
data.items[]— at most 200 — mp_code (marketplace), purchase_item_nr (the purchased item being returned), partner_sku, merchant_code, references[] {barcode, barcode_type: awb_nr or rms_barcode}.