Happklaar API
string · minLength: 4 · maxLength: 32 · requiredstring · minLength: 2 · maxLength: 2
Properties for Variant 1:string · requiredstring · requiredstring · requiredstring · required
POST
https://api.happklaar.nl/v1
/billing/btw-validate
Request Body
FormRequest for POST /v1/billing/btw-validate.
Single SPA endpoint that fronts the {@see \Modules\Tax\Services\ViesValidator}.
The SPA debounces input by 400ms on-blur and posts {btw_id, country?}
with an AbortController that cancels any in-flight prior request.
`country` is optional — when absent the controller decodes the country
code from the BTW id's two-letter ISO prefix (e.g. `NL123…` → `NL`).
Callers that already know the issuing country (e.g. a multi-country B2B
onboarding form where the country is asked first) may pass it
explicitly. The validator accepts only ISO 3166-1 alpha-2 codes
uppercased downstream.
btw_idcountryResponses
anyOf
At least one variant must match. Multiple variants may match simultaneously.
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: status, verified_name, verified_address +1 more | |
| type = object · requires: status, verified_name, verified_address +1 more |
statusverified_nameverified_addressreason