POpolar
refunds
public

List Refunds

List refunds.

Scopes: refunds:read refunds:write

get/v1/refunds/

Request

  • Base URL
    https://api.polar.sh
  • URL
    https://api.polar.sh/v1/refunds/
  • Auth
    • OpenID Connect (/.well-known/openid-configuration, scopes: refunds:read, refunds:write)
    • or HTTP bearer
    • or HTTP bearer

Query parameters

string uuid4

The refund ID.

OR
string[]
string uuid4

The organization ID.

OR
string[]
Example:1dbfc517-0bbf-4301-9ba8-555ca42b9737
string uuid4

The order ID.

OR
string[]
string uuid4

The subscription ID.

OR
string[]
string uuid4

The customer ID.

OR
string[]
string

The customer external ID.

OR
string[]
succeededboolean nullable

Filter by succeeded.

pageinteger

Page number, defaults to 1.

limitinteger

Size of a page, defaults to 10. Maximum is 100.

sortingRefundSortProperty[] nullable

Sorting criterion. Several criteria can be used simultaneously and will be applied in order. Add a minus sign - before the criteria name to sort by descending order.

Response

Successful Response

Example response

{
  "items": [
    {
      "dispute": {
        "amount": 1000,
        "tax_amount": 200,
        "currency": "usd",
        "reason": "fraudulent",
        "order_id": "57107b74-8400-4d80-a2fc-54c2b4239cb3",
        "payment_id": "42b94870-36b9-4573-96b6-b90b1c99a353"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 11 revisions of this API.