Tax

List US nexus configurations

Return all US nexus configurations for the merchant (state-level nexus records).

GET
/tax/nexus

Authorization

bearerAuth
AuthorizationBearer <token>

Use your secret API key as the bearer token

In: header

Response Body

application/json

application/json

curl -X GET "https://api.getlumen.dev/v1/tax/nexus"
[
  {
    "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-10T05:11:43.000Z"
  }
]
{
  "error": "Internal server error"
}