Get Seller Initiated Refunds for an order

GET

https://marketplace-order-api.feedamp.feedonomics.com/api/v1/orders/:mp_order_number/refunds

GET

/api/v1/orders/:mp_order_number/refunds

1 curl https://marketplace-order-api.feedamp.feedonomics.com/api/v1/orders/mp_order_number/refunds \
2      -H "Authorization: Bearer <token>"

1 {
2   "refunds": [
3     {
4       "feedamp_refund_id": 1001,
5       "mp_order_number": "ABC-123",
6       "status": "CREATED",
7       "date_created": "2023-05-02",
8       "merchant_refund_lines": [
9         {
10           "mp_line_number": "ABC-123-GHY-219",
11           "currency": "USD",
12           "refund_quantity": 1,
13           "item_refund": 6.99,
14           "item_tax_refund": 0.11,
15           "shipping_refund": 0,
16           "shipping_tax_refund": 0,
17           "discount_refund": 0,
18           "reason": "CUSTOMER_CANCELLED"
19         }
20       ],
21       "errors": [
22         {
23           "code": "EXCESS_ITEM_REFUND",
24           "message": "Requested refund amount (100.99) exceeds the line's cost (75.99)"
25         }
26       ]
27     }
28   ],
29   "next_cursor": "12FDG-31dsfgHW"
30 }

Get all seller-initiated refunds for an order

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

mp_order_numberstringRequired

The unique Id for an order that is generated by the marketplace

Response

Order Refunds

refundslist of objects

next_cursorstring

The cursor to get the next page of orders

Errors

401

Unauthorized Error

404

Not Found Error