Skip to content

Delist Tax Refund Method

Marks a tax refund method as delisted, removing it from active use.

This endpoint marks a tax refund method as delisted, removing it from active use. Delisted methods will not appear in list results, but can still be retrieved directly by their ID. Once delisted, the method's delist_info field will be populated with the time and user that performed the delisting.

Endpoint

MethodUrl
POST/v1.0/tax-refund-methods/:id/delist

Path Parameters

id
string
required

The unique identifier of the tax refund method to delist.

Request Body

No request body is required for this endpoint.

Sample Request

bash
Copied
1curl -X POST 'https://api.worklayer.com/v1.0/tax-refund-methods/550e8400-e29b-41d4-a716-446655440000/delist' \
2-H 'Authorization: Bearer {token}'

Response

The response body is empty on successful delisting.

Sample Response

json
Copied
1{}

Errors

  • 400: Invalid tax refund method ID format
  • 403: You're not allowed to delist this refund method
  • 404: The refund method was not found
Last updated on March 10, 2026