Merchant Nexus

Delete Nexus Location

<span class="plan-badge plan-badge--pro">Available on Pro and Enterprise Plans</span> Removes a recorded location so it no longer contributes to the merchant's nexus. The location stops appearing in /merchant/nexus/list immediately, and is retained internally so past filings keep their basis. Removing a merchant's last location is allowed: it simply means no physical nexus is tracked for them. Deleting a location that is already gone returns 404. Available to self-managed merchants only; a TaxCloud-connected merchant returns 403.

Authentication

X-API-KEYstring
API Key authentication via header

Request

This endpoint expects an object.
locationIdstringRequired

Identifier of the location to remove, as returned by /merchant/nexus/create or /merchant/nexus/list.

merchantIdstringRequired

UUID of the merchant that owns the location. Must be owned by the calling account and must be self-managed.

Response

OK
locationIdstring
Identifier of the removed location.
merchantIdstring
UUID of the merchant the location belonged to.
messagestring

Human-readable description of the result.

Errors

400
Merchant Nexus Delete Body Bad Request Error
401
Merchant Nexus Delete Body Unauthorized Error
403
Merchant Nexus Delete Body Forbidden Error
404
Merchant Nexus Delete Body Not Found Error
422
Merchant Nexus Delete Body Unprocessable Entity Error
429
Merchant Nexus Delete Body Too Many Requests Error
500
Merchant Nexus Delete Body Internal Server Error
503
Merchant Nexus Delete Body Service Unavailable Error