Tax
Create or update nexus for a state
Create or update a US nexus configuration for the given 2-letter state code.
Authorization
bearerAuth AuthorizationBearer <token>
Use your secret API key as the bearer token
In: header
Path Parameters
state*string
Two-letter US state or territory code
Match
^[A-Za-z]{2}$Request Body
application/json
hasNexus*boolean
Whether the merchant has nexus in this state
nexusType?string|null
physical, economic, marketplace, or custom label
salesThreshold?integer|null
Sales threshold in cents for nexus
Range
0 <= valuetransactionThreshold?integer|null
Transaction count threshold for nexus
Range
0 <= valuehasOffices?boolean|null
hasEmployees?boolean|null
hasInventory?boolean|null
otherPresence?string|null
Response Body
application/json
application/json
application/json
curl -X POST "https://api.getlumen.dev/v1/tax/nexus/string/update" \ -H "Content-Type: application/json" \ -d '{ "hasNexus": true, "nexusType": "economic", "salesThreshold": 500000, "transactionThreshold": 200, "hasEmployees": true }'{
"id": "us_nexus_cfg_7WvJ5sXH4QkP0LmNaCdEfB",
"merchantId": "mer_4aExPpQ7R3tSa1BcDe9LmN",
"state": "CA",
"hasNexus": true,
"nexusType": "economic",
"salesThreshold": 500000,
"transactionThreshold": 200,
"hasOffices": false,
"hasEmployees": true,
"hasInventory": false,
"createdAt": "2025-02-10T05:11:43.000Z",
"updatedAt": "2025-02-20T08:10:00.000Z"
}{
"error": "Invalid US state or territory code"
}{
"error": "Internal server error"
}