Tax
Create tax registration
Create a tax registration for a jurisdiction.
Authorization
bearerAuth AuthorizationBearer <token>
Use your secret API key as the bearer token
In: header
Request Body
application/json
jurisdiction*string
Country/region code for the registration
registrationNumber*string
Tax registration number
taxType*string
Type of tax (VAT, GST, sales_tax, etc.)
isActive?boolean|null
Whether this registration is active
Response Body
application/json
application/json
application/json
curl -X POST "https://api.getlumen.dev/v1/tax/registrations/create" \ -H "Content-Type: application/json" \ -d '{ "jurisdiction": "DE", "registrationNumber": "DE123456789", "taxType": "VAT" }'{
"id": "tax_reg_3FgH5jKl9Zx1v2Bn4pQrSt",
"merchantId": "mer_4aExPpQ7R3tSa1BcDe9LmN",
"jurisdiction": "DE",
"registrationNumber": "DE123456789",
"taxType": "VAT",
"isActive": true,
"createdAt": "2025-02-20T08:10:00.000Z",
"updatedAt": "2025-02-20T08:10:00.000Z"
}{
"error": [
{
"code": "invalid_type",
"message": "Required",
"path": [
"jurisdiction"
]
}
]
}{
"error": "Internal server error"
}