Required scopes:
returns_read,
returns_write
How the customer is compensated (e.g. refund, store credit, exchange).
Whether the return was closed without any action taken.
When the return was created.
Where the returned items are sent (the merchant).
The merchant’s return address.
The first line of the address (street and number).
The second line of the address (apartment, suite, unit, etc.).
The city, town, or village.
The province, state, or region.
A contact phone number for the destination.
Chosen label-free dropoffs for returning items.
The merchant-facing dropoff provider name.
The dropoff QR code, if any.
A URL to the dropoff QR code, if any.
The shipment group this dropoff is for.
Exchange details for the return.
Total quantity of exchange items.
The items on the exchange order.
The exchange order’s line item id, if known.
The item’s original price.
The exchanged-for variant.
The exchange/new order.
The exchange order’s external id.
How the exchange is provisioned.
Total tax on the exchange order.
The exact amount as a decimal string (e.g. “19.99”).
ISO 4217 currency code (e.g. USD).
This return’s ids in external systems (e.g. Shopify).
The external system, e.g. shopify.
The id within that system.
Gift cards issued as part of the return.
The gift card’s value.
The exact amount as a decimal string (e.g. “19.99”).
ISO 4217 currency code (e.g. USD).
The gift card’s id in the external system.
Links to this return in external integrations.
The id of the record in the external system.
The integration provider.
The kind of external record (e.g. rma).
The name of the merchant user who created the return, if merchant-created.
The items being returned.
Merchant assessments recorded for the item, if any.
The user who performed the assessment.
The assessment responses.
Free-text comments the customer left for this item.
The item exchanged for this one, if an exchange.
The exchanged-for product.
The exchanged-for variant.
A merchant-set external identifier for the item.
The external return line item id, if any.
The merchant-assigned grade.
Whether the item is a green (keep-it) return.
Multiple-choice question answers for the item.
The id of the order line item this return item came from.
The merchant-assigned processing outcome.
Merchant-uploaded processing images.
Merchant processing notes.
The merchant price adjustment for the item.
The item’s product value excluding tax and adjustments.
The refund for this item.
The refunded amount for the item.
The compensation strategy (null for exchanges).
Shipment groups this item belongs to.
The item’s processing status.
The return’s legacy Mongo ObjectId (24-char hex), for cross-referencing v2 data.
Non-system notes on the return’s timeline.
A URL of the first image attached to the note, if any.
The order this return was created against.
The order’s legacy Mongo ObjectId (24-char hex). Use orders for the modeled Order relationship.
The order’s display name, e.g. #1001.
The orders the returned items came from.Requires:
orders_read
ArgumentsForward cursor — orders after this edges[].cursor.
Backward cursor — orders before this edges[].cursor.
Forward pagination: the first N orders (max 100, default 25). Use with after.
Backward pagination: the last N orders (max 100, default 25). Use with before.
The list of edges (each a node plus its pagination cursor).
Opaque cursor for this item; pass to after/before to page from here.
The nodes in this page, without the edge/cursor wrapper — a convenience over edges.
When the order was placed (the ecommerce provider’s creation time, falling back to Redo’s ingestion time).
The ISO 4217 currency code the order was placed in.
The customer who placed the order, if known.
The order’s id in the source ecommerce platform.
The shipments fulfilling this order’s items.
The order’s legacy Mongo ObjectId (24-char hex) from before the CockroachDB migration.
The items purchased on this order.
The order’s shipping method, cost, and destination.
The order subtotal, excluding tax and shipping, if known.
Free-form tags applied to the order.
The order total, including tax and shipping, if known.
The total tax charged on the order, if known.
Pagination metadata for the current page.
Cursor of the last edge in this page; pass to after to page forward.
Whether more items exist after this page (drives forward pagination with first/after).
Whether more items exist before this page (drives backward pagination with last/before).
Cursor of the first edge in this page; pass to before to page backward.
Refund transactions issued for the return.
The refunded amount.
The exact amount as a decimal string (e.g. “19.99”).
ISO 4217 currency code (e.g. USD).
The refund/transaction id in the external system.
The return’s primary shipment, if any.
When the shipment was delivered, if it has been.
The carrier’s estimated delivery date, if any.
The destination external location id, if any.
A URL to the customs/return form, if any.
Ids of the return items in this shipment.
A URL to the postage label, if any.
The shipment group this shipment belongs to.
All shipments for the return.
When the shipment was delivered, if it has been.
The carrier’s estimated delivery date, if any.
The destination external location id, if any.
A URL to the customs/return form, if any.
Ids of the return items in this shipment.
A URL to the postage label, if any.
The shipment group this shipment belongs to.
Who the return is from (the customer).
The customer’s email address.
The customer’s shipping address, if known.
The first line of the address (street and number).
The second line of the address (apartment, suite, unit, etc.).
The city, town, or village.
The province, state, or region.
A contact phone number for the customer.
The return’s current lifecycle status.
Tags applied to the return.
What applied the tag (e.g. merchant, automation).
The monetary totals for the return.
Outstanding balance charged to the customer.
Value of the new/exchange order.
Merchant’s return-label cost. Not stored on the returns mirror (lives in billing) — returned as 0 here.
Total refunded to the customer (excluding shipping).
Total issued as store credit.
What kind of return this is.
When the return was last updated.
