Syntax
=DRAGON_RETURNS(account, [ASIN/SKU], [marketplace], [period], [reason], [status], [disposition], [columns], [header], [transpose])
Parameters in [brackets] are optional. Leave an optional parameter blank to include everything.
This page is also available inside Sheets – type
=DRAGON_RETURNS("help") in any cell to get the same reference without leaving your spreadsheet.Sample output
Example output from the Nordvik demo store – your sheet shows your own store's data.
A1fx
=DRAGON_RETURNS("Nordvik", "", "US", "last 90 days")| A | B | C | D | E | F | G | H | I | |
|---|---|---|---|---|---|---|---|---|---|
| 1 | marketplace | return_date | order_id | sku | asin | fnsku | quantity | fulfillment_center_id | … |
| 2 | US | 2026-10-12 | 113-1234560-7654321 | NV-HAT-CHARCOAL | B0KNIT0101 | X0KNIT0101 | 85 | CLT2 | … 4 more |
| 3 | US | 2026-10-11 | 113-1234671-7653210 | NV-HAT-NAVY | B0KNIT0104 | X0KNIT0104 | 19 | LAX9 | … 4 more |
| 4 | US | 2026-10-10 | 113-1234782-7652099 | NV-TEE-BLACK-L | B0KNIT0109 | X0KNIT0109 | 50 | MDW2 | … 4 more |
| 5 | US | 2026-10-09 | 113-1234893-7650988 | NV-SWT-CHARCOAL-L | B0KNIT0121 | X0KNIT0121 | 81 | RIC2 | … 4 more |
Parameters
| Parameter | Required | Description |
|---|---|---|
| account | Required | Account nickname, account number (1, 2, ...) or Amazon account id. Leave empty if you have only one account. |
| ASIN/SKU | Optional | Optional ASIN, SKU, or a list separated by ;. Also accepts a cell range like A2:A100 or INDIRECT() pointing to a list. |
| marketplace | Optional | Optional marketplace/country code such as US, CA, or MX. |
| period | Optional | Optional period such as last 90 days, 2026-04, or 2026. Default: last 90 days. |
| reason | Optional | Optional return reason filter (common codes listed; Amazon also emits prefixed variants such as CR-DEFECTIVE, which pass through). |
| status | Optional | Optional return status filter. Separate several with ;. |
| disposition | Optional | Optional detailed disposition filter. |
| columns | Optional | Optional output columns separated by ;. |
| header | Optional | Use no, false, or 0 to suppress the output header row. Default: Yes. |
| transpose | Optional | Use yes, true, or 1 to transpose the output. |
The period accepts values like last_30_days, this_month, 2026Q1, or ranges like 2026-01-01..today – see the full period reference.
Columns
Columns are evaluated left to right: a field or group name adds columns, a leading - removes them. default and all select the default or full column set.
| Column | Default | Description |
|---|---|---|
| marketplace | Yes | Marketplace. |
| marketplace_id | No | Marketplace id. |
| return_date | Yes | Return date. |
| order_id | Yes | Order id. |
| sku | Yes | Sku. |
| asin | Yes | Asin. |
| fnsku | Yes | Fnsku. |
| quantity | Yes | Quantity. |
| fulfillment_center_id | Yes | Fulfillment center id. |
| detailed_disposition | Yes | Detailed disposition. |
| reason | Yes | Reason. |
| status | Yes | Status. |
| customer_comments | Yes | Customer comments. |
| license_plate_number | No | License plate number. |
| seller_id | No | Seller id. |
| return_id | No | Return identity within seller and marketplace. |
| fulfillment_type | No | FBA or FBM. |
| order_item_id | No | Original order item id. |
| amazon_rma_id | No | FBM return authorization id. |
| return_request_date | No | FBM return request date. |
Examples
=DRAGON_RETURNS("Mystore", "", "US", "last 90 days")