Retrieve a list of returns

GET {{baseUrl}}/returns?cursor=<string>

Retrieve a paginated list of all the returns belonging to the authenticated user, sorted by the creation date.

Request Params

KeyDatatypeRequiredDescription
cursorstringThe cursor query string will be used as the pivot value to filter results. If no value is provided, the service must return the first page. The value is Base64 encoded GET parameters. example:
For a cursor string there are 3 possible parameters to encode:

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;next&quot;:&quot;\u003cstring\u003e&quot;,&quot;previous&quot;:&quot;\u003cstring\u003e&quot;,&quot;returns&quot;:[{&quot;id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;created_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;reason&quot;:&quot;\u003cinteger\u003e&quot;,&quot;outgoing_parcel&quot;:&quot;\u003cinteger\u003e&quot;,&quot;incoming_parcel&quot;:&quot;\u003cinteger\u003e&quot;,&quot;message&quot;:&quot;\u003cstring\u003e&quot;,&quot;refund&quot;:{&quot;total_refund&quot;:&quot;\u003cstring\u003e&quot;,&quot;refunded_at&quot;:&quot;\u003cinteger\u003e&quot;,&quot;message&quot;:&quot;\u003cstring\u003e&quot;,&quot;refund_type&quot;:{&quot;code&quot;:&quot;exchange&quot;,&quot;label&quot;:&quot;\u003cstring\u003e&quot;,&quot;require_message&quot;:&quot;\u003cboolean\u003e&quot;}},&quot;is_cancellable&quot;:&quot;\u003cboolean\u003e&quot;,&quot;return_fee&quot;:&quot;\u003cnumber\u003e&quot;,&quot;return_fee_currency&quot;:&quot;\u003cstring\u003e&quot;,&quot;label_cost&quot;:&quot;\u003cnumber\u003e&quot;,&quot;label_currency&quot;:&quot;\u003cstring\u003e&quot;,&quot;items_cost&quot;:&quot;\u003cnumber\u003e&quot;,&quot;delivered_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;delivery_option&quot;:&quot;drop_off_labelless&quot;,&quot;store_location&quot;:&quot;\u003cinteger\u003e&quot;,&quot;outgoing_parcel_data&quot;:{&quot;tracking_url&quot;:&quot;\u003curi\u003e&quot;,&quot;tracking_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;parcel_status&quot;:&quot;\u003cinteger\u003e&quot;,&quot;global_status_slug&quot;:&quot;\u003cstring\u003e&quot;,&quot;brand_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;order_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;from_email&quot;:&quot;\u003cemail\u003e&quot;,&quot;deleted&quot;:&quot;\u003cboolean\u003e&quot;,&quot;collo_count&quot;:&quot;\u003cinteger\u003e&quot;,&quot;from_country&quot;:&quot;\u003cstring\u003e&quot;,&quot;from_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;shipping_method&quot;:&quot;\u003cinteger\u003e&quot;,&quot;extra_data&quot;:{},&quot;rules&quot;:[{&quot;modifications&quot;:[{&quot;field&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:{&quot;description&quot;:&quot;The value the field was changed to. The type depends on the field type&quot;}},{&quot;field&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:{&quot;description&quot;:&quot;The value the field was changed to. The type depends on the field type&quot;}}]},{&quot;modifications&quot;:[{&quot;field&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:{&quot;description&quot;:&quot;The value the field was changed to. The type depends on the field type&quot;}},{&quot;field&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:{&quot;description&quot;:&quot;The value the field was changed to. The type depends on the field type&quot;}}]}]},&quot;incoming_parcel_data&quot;:{&quot;tracking_url&quot;:&quot;\u003curi\u003e&quot;,&quot;tracking_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;parcel_status&quot;:&quot;\u003cinteger\u003e&quot;,&quot;global_status_slug&quot;:&quot;\u003cstring\u003e&quot;,&quot;brand_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;order_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;from_email&quot;:&quot;\u003cemail\u003e&quot;,&quot;deleted&quot;:&quot;\u003cboolean\u003e&quot;,&quot;collo_count&quot;:&quot;\u003cinteger\u003e&quot;,&quot;from_country&quot;:&quot;\u003cstring\u003e&quot;,&quot;from_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;shipping_method&quot;:&quot;\u003cinteger\u003e&quot;,&quot;extra_data&quot;:{},&quot;rules&quot;:[{&quot;modifications&quot;:[{&quot;field&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:{&quot;description&quot;:&quot;The value the field was changed to. The type depends on the field type&quot;}},{&quot;field&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:{&quot;description&quot;:&quot;The value the field was changed to. The type depends on the field type&quot;}}]},{&quot;modifications&quot;:[{&quot;field&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:{&quot;description&quot;:&quot;The value the field was changed to. The type depends on the field type&quot;}},{&quot;field&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:{&quot;description&quot;:&quot;The value the field was changed to. The type depends on the field type&quot;}}]}],&quot;customs_information&quot;:{&quot;customs_invoice_nr&quot;:&quot;\u003cstring\u003e&quot;,&quot;customs_shipment_type&quot;:&quot;\u003cinteger\u003e&quot;,&quot;export_type&quot;:&quot;private&quot;,&quot;invoice_date&quot;:&quot;\u003cdate\u003e&quot;,&quot;discount_granted&quot;:&quot;\u003cstring\u003e&quot;,&quot;freight_costs&quot;:&quot;\u003cstring\u003e&quot;,&quot;insurance_costs&quot;:&quot;\u003cstring\u003e&quot;,&quot;other_costs&quot;:&quot;\u003cstring\u003e&quot;,&quot;general_notes&quot;:&quot;\u003cstring\u003e&quot;,&quot;additional_declaration_statements&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;importer_of_record&quot;:{&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;address_1&quot;:&quot;\u003cstring\u003e&quot;,&quot;city&quot;:&quot;\u003cstring\u003e&quot;,&quot;postal_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;country_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;company_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;address_2&quot;:&quot;\u003cstring\u003e&quot;,&quot;house_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;country_state&quot;:&quot;\u003cstring\u003e&quot;,&quot;telephone&quot;:&quot;\u003cstring\u003e&quot;,&quot;email&quot;:&quot;\u003cstring\u003e&quot;},&quot;tax_numbers&quot;:{&quot;sender&quot;:[{&quot;name&quot;:&quot;DTF&quot;,&quot;country_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:&quot;\u003cstring\u003e&quot;},{&quot;name&quot;:&quot;GST&quot;,&quot;country_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:&quot;\u003cstring\u003e&quot;}],&quot;receiver&quot;:[{&quot;name&quot;:&quot;DUN&quot;,&quot;country_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:&quot;\u003cstring\u003e&quot;},{&quot;name&quot;:&quot;DAN&quot;,&quot;country_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:&quot;\u003cstring\u003e&quot;}],&quot;importer_of_record&quot;:[{&quot;name&quot;:&quot;GST&quot;,&quot;country_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:&quot;\u003cstring\u003e&quot;},{&quot;name&quot;:&quot;EIN&quot;,&quot;country_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:&quot;\u003cstring\u003e&quot;}]},&quot;return_data&quot;:{&quot;return_postal_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;outbound_tracking_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;outbound_shipment_date&quot;:&quot;\u003cdate\u003e&quot;,&quot;outbound_carrier_name&quot;:&quot;\u003cstring\u003e&quot;}}},&quot;incoming_parcel_status&quot;:{&quot;id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;message&quot;:&quot;\u003cstring\u003e&quot;,&quot;global_status_slug&quot;:&quot;\u003cstring\u003e&quot;},&quot;images&quot;:[{&quot;path&quot;:&quot;\u003curi\u003e&quot;,&quot;product_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;},{&quot;path&quot;:&quot;\u003curi\u003e&quot;,&quot;product_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;}],&quot;rule_modifications&quot;:[{&quot;rule_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;field&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:{&quot;description&quot;:&quot;New value of the field based on this rule. The type depends on the field type.&quot;},&quot;action&quot;:&quot;\u003cstring\u003e&quot;,&quot;friendly_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;priority&quot;:&quot;\u003cinteger\u003e&quot;,&quot;item_id&quot;:&quot;\u003cstring\u003e&quot;},{&quot;rule_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;field&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:{&quot;description&quot;:&quot;New value of the field based on this rule. The type depends on the field type.&quot;},&quot;action&quot;:&quot;\u003cstring\u003e&quot;,&quot;friendly_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;priority&quot;:&quot;\u003cinteger\u003e&quot;,&quot;item_id&quot;:&quot;\u003cstring\u003e&quot;}]},{&quot;id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;created_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;reason&quot;:&quot;\u003cinteger\u003e&quot;,&quot;outgoing_parcel&quot;:&quot;\u003cinteger\u003e&quot;,&quot;incoming_parcel&quot;:&quot;\u003cinteger\u003e&quot;,&quot;message&quot;:&quot;\u003cstring\u003e&quot;,&quot;refund&quot;:{&quot;total_refund&quot;:&quot;\u003cstring\u003e&quot;,&quot;refunded_at&quot;:&quot;\u003cinteger\u003e&quot;,&quot;message&quot;:&quot;\u003cstring\u003e&quot;,&quot;refund_type&quot;:{&quot;code&quot;:&quot;money&quot;,&quot;label&quot;:&quot;\u003cstring\u003e&quot;,&quot;require_message&quot;:&quot;\u003cboolean\u003e&quot;}},&quot;is_cancellable&quot;:&quot;\u003cboolean\u003e&quot;,&quot;return_fee&quot;:&quot;\u003cnumber\u003e&quot;,&quot;return_fee_currency&quot;:&quot;\u003cstring\u003e&quot;,&quot;label_cost&quot;:&quot;\u003cnumber\u003e&quot;,&quot;label_currency&quot;:&quot;\u003cstring\u003e&quot;,&quot;items_cost&quot;:&quot;\u003cnumber\u003e&quot;,&quot;delivered_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;delivery_option&quot;:&quot;in_store&quot;,&quot;store_location&quot;:&quot;\u003cinteger\u003e&quot;,&quot;outgoing_parcel_data&quot;:{&quot;tracking_url&quot;:&quot;\u003curi\u003e&quot;,&quot;tracking_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;parcel_status&quot;:&quot;\u003cinteger\u003e&quot;,&quot;global_status_slug&quot;:&quot;\u003cstring\u003e&quot;,&quot;brand_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;order_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;from_email&quot;:&quot;\u003cemail\u003e&quot;,&quot;deleted&quot;:&quot;\u003cboolean\u003e&quot;,&quot;collo_count&quot;:&quot;\u003cinteger\u003e&quot;,&quot;from_country&quot;:&quot;\u003cstring\u003e&quot;,&quot;from_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;shipping_method&quot;:&quot;\u003cinteger\u003e&quot;,&quot;extra_data&quot;:{},&quot;rules&quot;:[{&quot;modifications&quot;:[{&quot;field&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:{&quot;description&quot;:&quot;The value the field was changed to. The type depends on the field type&quot;}},{&quot;field&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:{&quot;description&quot;:&quot;The value the field was changed to. The type depends on the field type&quot;}}]},{&quot;modifications&quot;:[{&quot;field&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:{&quot;description&quot;:&quot;The value the field was changed to. The type depends on the field type&quot;}},{&quot;field&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:{&quot;description&quot;:&quot;The value the field was changed to. The type depends on the field type&quot;}}]}]},&quot;incoming_parcel_data&quot;:{&quot;tracking_url&quot;:&quot;\u003curi\u003e&quot;,&quot;tracking_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;parcel_status&quot;:&quot;\u003cinteger\u003e&quot;,&quot;global_status_slug&quot;:&quot;\u003cstring\u003e&quot;,&quot;brand_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;order_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;from_email&quot;:&quot;\u003cemail\u003e&quot;,&quot;deleted&quot;:&quot;\u003cboolean\u003e&quot;,&quot;collo_count&quot;:&quot;\u003cinteger\u003e&quot;,&quot;from_country&quot;:&quot;\u003cstring\u003e&quot;,&quot;from_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;shipping_method&quot;:&quot;\u003cinteger\u003e&quot;,&quot;extra_data&quot;:{},&quot;rules&quot;:[{&quot;modifications&quot;:[{&quot;field&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:{&quot;description&quot;:&quot;The value the field was changed to. The type depends on the field type&quot;}},{&quot;field&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:{&quot;description&quot;:&quot;The value the field was changed to. The type depends on the field type&quot;}}]},{&quot;modifications&quot;:[{&quot;field&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:{&quot;description&quot;:&quot;The value the field was changed to. The type depends on the field type&quot;}},{&quot;field&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:{&quot;description&quot;:&quot;The value the field was changed to. The type depends on the field type&quot;}}]}],&quot;customs_information&quot;:{&quot;customs_invoice_nr&quot;:&quot;\u003cstring\u003e&quot;,&quot;customs_shipment_type&quot;:&quot;\u003cinteger\u003e&quot;,&quot;export_type&quot;:&quot;commercial_b2b&quot;,&quot;invoice_date&quot;:&quot;\u003cdate\u003e&quot;,&quot;discount_granted&quot;:&quot;\u003cstring\u003e&quot;,&quot;freight_costs&quot;:&quot;\u003cstring\u003e&quot;,&quot;insurance_costs&quot;:&quot;\u003cstring\u003e&quot;,&quot;other_costs&quot;:&quot;\u003cstring\u003e&quot;,&quot;general_notes&quot;:&quot;\u003cstring\u003e&quot;,&quot;additional_declaration_statements&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;importer_of_record&quot;:{&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;address_1&quot;:&quot;\u003cstring\u003e&quot;,&quot;city&quot;:&quot;\u003cstring\u003e&quot;,&quot;postal_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;country_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;company_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;address_2&quot;:&quot;\u003cstring\u003e&quot;,&quot;house_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;country_state&quot;:&quot;\u003cstring\u003e&quot;,&quot;telephone&quot;:&quot;\u003cstring\u003e&quot;,&quot;email&quot;:&quot;\u003cstring\u003e&quot;},&quot;tax_numbers&quot;:{&quot;sender&quot;:[{&quot;name&quot;:&quot;DTF&quot;,&quot;country_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:&quot;\u003cstring\u003e&quot;},{&quot;name&quot;:&quot;STA&quot;,&quot;country_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:&quot;\u003cstring\u003e&quot;}],&quot;receiver&quot;:[{&quot;name&quot;:&quot;FED&quot;,&quot;country_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:&quot;\u003cstring\u003e&quot;},{&quot;name&quot;:&quot;DUN&quot;,&quot;country_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:&quot;\u003cstring\u003e&quot;}],&quot;importer_of_record&quot;:[{&quot;name&quot;:&quot;DUN&quot;,&quot;country_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:&quot;\u003cstring\u003e&quot;},{&quot;name&quot;:&quot;RGP&quot;,&quot;country_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:&quot;\u003cstring\u003e&quot;}]},&quot;return_data&quot;:{&quot;return_postal_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;outbound_tracking_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;outbound_shipment_date&quot;:&quot;\u003cdate\u003e&quot;,&quot;outbound_carrier_name&quot;:&quot;\u003cstring\u003e&quot;}}},&quot;incoming_parcel_status&quot;:{&quot;id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;message&quot;:&quot;\u003cstring\u003e&quot;,&quot;global_status_slug&quot;:&quot;\u003cstring\u003e&quot;},&quot;images&quot;:[{&quot;path&quot;:&quot;\u003curi\u003e&quot;,&quot;product_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;},{&quot;path&quot;:&quot;\u003curi\u003e&quot;,&quot;product_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;}],&quot;rule_modifications&quot;:[{&quot;rule_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;field&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:{&quot;description&quot;:&quot;New value of the field based on this rule. The type depends on the field type.&quot;},&quot;action&quot;:&quot;\u003cstring\u003e&quot;,&quot;friendly_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;priority&quot;:&quot;\u003cinteger\u003e&quot;,&quot;item_id&quot;:&quot;\u003cstring\u003e&quot;},{&quot;rule_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;field&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:{&quot;description&quot;:&quot;New value of the field based on this rule. The type depends on the field type.&quot;},&quot;action&quot;:&quot;\u003cstring\u003e&quot;,&quot;friendly_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;priority&quot;:&quot;\u003cinteger\u003e&quot;,&quot;item_id&quot;:&quot;\u003cstring\u003e&quot;}]}]}