GET
Get return order

Authorizations

x-api-key
string
header
required

Path Parameters

id
string
required

Melonn internal order number of the return order (internal_order_number, e.g. R00527), as returned by Create return order or List return orders. Not the numeric id, and not your external order number.

Response

The return order.

id
integer

Numeric Melonn ID of the return order.

Example:

527

internal_order_number
string

Melonn internal order number of the return order. Use it to get or cancel the return.

Example:

"R00527"

external_order_number
string

Your identifier for the return, as sent on creation.

Example:

"test-public-api-001"

external_order_id
string | null

Your secondary identifier for the return, or null if none was sent.

Example:

null

assigned_warehouse_code
string

Code of the warehouse that receives the return.

Example:

"WCOD-1"

buyer_full_name
string

Full name of the buyer.

Example:

"Jane Doe"

creation_date
string<date-time>

When the return order was created (UTC).

Example:

"2025-12-01T16:16:13.000Z"

last_modified_date
string<date-time> | null

When the return order was last modified (UTC).

Example:

"2025-12-01T16:16:13.000Z"

buyer_return_order_state
object

Current state of the return order.

return_full_label_url
string

Pre-signed download link to the return label PDF, valid for 72 hours (3 days) from the response. Empty string when the label is not ready yet.

Example:

"https://example-bucket.s3.amazonaws.com/R00527-melonn-full-label.pdf?X-Amz-Expires=259200&X-Amz-Signature=..."

line_items_summary
object[]

Returned products, as requested (kits are kept as kits).

parent_sell_order
object

The sell order this return was created from.