Billing

Read the platform B2C EU VAT mode#

GET /api/v1/platform/vat-mode

Requires authentication (Bearer token) and the X-Organization-Id header.

Deployment-level tax registration status (#703). home_country = all EU consumers are charged the seller country rate (legal under the €10,000 EU micro-business threshold, Art. 59c — domestic sales do not count); oss_destination = buyer member-state rate (requires OSS registration). Only the PLATFORM organization's own token may call this — tenant orgs receive 403. Requires the organizations.view scope.

Responses#

Example request#

curl -X GET "https://app.encryptinvoice.com/api/v1/platform/vat-mode" \
  -H "Authorization: Bearer {{access_token}}" \
  -H "X-Organization-Id: {{organization_id}}" \
  -H "Accept: application/json"

Switch the platform B2C EU VAT mode#

PUT /api/v1/platform/vat-mode

Requires authentication (Bearer token) and the X-Organization-Id header.

Audit-logged (who/when/from/to). Only the platform organization's own token; requires the organizations.update scope. Switch to oss_destination BEFORE crossing the €10,000 threshold.

Request body#

Responses#

Example request#

curl -X PUT "https://app.encryptinvoice.com/api/v1/platform/vat-mode" \
  -H "Authorization: Bearer {{access_token}}" \
  -H "X-Organization-Id: {{organization_id}}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "b2c_eu_mode": "string"
}'