Get Seller Initiated Refunds | feedonomics

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

{
  "refunds": [
    {
      "feedamp_refund_id": 1001,
      "mp_order_number": "ABC-123",
      "status": "CREATED",
      "date_created": "2023-05-02",
      "merchant_refund_lines": [
        {
          "mp_line_number": "ABC-123-GHY-219",
          "currency": "USD",
          "refund_quantity": 1,
          "item_refund": 6.99,
          "item_tax_refund": 0.11,
          "shipping_refund": 0,
          "shipping_tax_refund": 0,
          "discount_refund": 0,
          "reason": "CUSTOMER_CANCELLED"
        }
      ],
      "errors": [
        {
          "code": "EXCESS_ITEM_REFUND",
          "message": "Requested refund amount (100.99) exceeds the line's cost (75.99)"
        }
      ]
    }
  ],
  "next_cursor": "12FDG-31dsfgHW"
}

Get all seller-initiated refunds from FeedAMP, filtered by search criteria

Authentication

AuthorizationBearer

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

Query parameters

mp_order_numberslist of stringsOptional

Comma-delimited list of marketplace order numbers to ref refund information for

refund_statuslist of enumsOptional

Comma-delimited list of refunds statuses <ul>

CREATED refunds that are ready to be processed

PAUSED refunds that have unresolved errors

COMPLETE refunds that have been marked as complete by the marketplace

</ul>

Allowed values:

created_afterdatetimeOptional

Include refunds created on or after this date (format ISO 8601 default time zone is America/New_York)

created_beforedatetimeOptional

Include refunds created on or before this date (format ISO 8601 default time zone is America/New_York)

page_sizeintegerOptional10-50Defaults to 20

The number of orders per page to return

cursorstringOptional

Cursor for the next page of orders

Response

Order Refunds

refundslist of objects

next_cursorstring

The cursor to get the next page of orders

Errors

400

Bad Request Error

401

Unauthorized Error