Reverse Refund

Changed on Nov 3, 2026

Reverse a refund you've previously created

post/tax/refund_reversals

Request

Base URL
https://api.numeralhq.com
URL
https://api.numeralhq.com/tax/refund_reversals
Auth
HTTP bearer

Request body

refund_idstring required

The ID of the refund to reverse

Response

Refund response

idstring

The ID of the refund. We recommend you store this value. If you need to reverse this refund, you will be required to reference this ID.

objectstring

The type of object: tax.refund.

refund_typestring

This will be either 'full' or 'partial'.

testmodeboolean

True if using a production API key. False if using a test API key.

refund_processed_atnumber

Unix timestamp in seconds representing the date and time the refund was made. If not provided, the time the refund was created will be used.

Example response

{
  "id": "ref_tr_123456789",
  "object": "tax.refund",
  "refund_type": "partial",
  "refund_processed_at": 1714787673,
  "line_items": [
    {
      "line_item_id": "li_1783369661107e97b4af5-b61a-487d-aa31-ecee6e616f7f",
      "product": {
        "reference_product_name": "Red Shoes",
        "reference_line_item_id": "line_123456789",
        "reference_product_id": "p-1233543",
        "product_tax_code": "GENERAL_MERCHANDISE"
      },
      "tax_jurisdictions": [
        {
          "tax_rate": 0.07,
          "tax_due_decimal": 724.9275,
          "rate_type": "GENERAL STATE SALES TAX",
          "tax_authority_name": "Tennessee",
          "tax_type": "SALES"
        }
      ],
      "quantity": 2,
      "tax_amount": 14,
      "amount_excluding_tax": 200,
      "amount_including_tax": 214
    }
  ]
}

Changes

Nov 3, 2026f4650eaed11f Revision changes
- breaking
  the request property became required
- breaking
  the ////// response's property format changed from int32 to no format for status
- breaking
  the ////// response's property format changed from int32 to no format for status
- breaking
  the ////// response's property format changed from int32 to no format for status
- breaking
  the ////// response's property format changed from int32 to no format for status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- info
  api operation id reverseRefund_v20260301 was added
- info
  added the optional property ////// to the response with the status
- info
  removed subschema #2 from the / response property allOf list for the response status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status

Operation history