BillKit/Docs Console
Tenant

Update billing profile

Set your registered country, and optionally your own VAT number.

POST/v1/tenant/billing_profile
Operation update_billing_profile · Scope tenant:write · Spec snapshot 2026-09-13

Parameters

ParameterDescription
country_codestringrequiredAt most 2 characters.
address_line1string | nulloptionalAt most 255 characters.
address_line2string | nulloptionalAt most 255 characters.
citystring | nulloptionalAt most 128 characters.
postal_codestring | nulloptionalAt most 32 characters.
registration_numberstring | nulloptionalAt most 64 characters.
vat_idstring | nulloptionalAt most 64 characters.

Returns

Returns a TenantBillingProfileResponse object.

Errors

Status Cause
401 Missing or invalid API key.
403 Key is missing the tenant:write scope.
422 Validation Error
429 Rate limited. Back off and retry.
Request · curl 
curl -X POST https://api.billkit.eu/v1/tenant/billing_profile \
  -H "Authorization: Bearer $BILLKIT_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country_code":"NL"}'
Request body · every field 
{
  "address_line1": "string",
  "address_line2": "string",
  "city": "string",
  "country_code": "NL",
  "postal_code": "string",
  "registration_number": "string",
  "vat_id": "vat_9XKp2vQ1"
}
Response · 200 OK 
{
  "address_line1": "string",
  "address_line2": "string",
  "city": "string",
  "country_code": "NL",
  "effective_country_code": "NL",
  "object": "tenant_billing_profile",
  "postal_code": "string",
  "registration_number": "string",
  "tenant_id": "tenant_9XKp2vQ1",
  "vat_id": "vat_9XKp2vQ1"
}