Skip to content
Coritan Docs

Set your billing address and VAT ID

Put a legal name, a postal address and a VAT ID on your invoices from the Billing address tab of Settings, or read and change them through the API.

View as Markdown

In the dashboard

Every invoice PDF names who the invoice is made out to. Until you add a billing address, that is your name, company and email address from your profile. Add a billing address on the Billing address tab of Settings to put a legal name, a postal address and a VAT ID on your invoices instead.

  • Sign in to the dashboard.
  • Have the address you want on your invoices, and your VAT ID if you have one.

Add or change your billing address

Section titled Add or change your billing address
  1. In the sidebar, select Settings, then the Billing address tab.
  2. In Legal name, enter the person or company the invoices are made out to. You can leave it empty, and your invoices then show your name and company.
  3. Enter the Address, and Address line 2 if you need it.
  4. Enter the City or town. Add the State, county or region and the Postcode if your address has them.
  5. Choose the Country. Before you save a billing address, it starts as your billing country from the Profile tab.
  6. In VAT ID, enter your VAT number or other tax ID, if you have one. We take out spaces, dots and hyphens and store it in capitals, so gb 123.456 789 becomes GB123456789.
  7. Select Save billing address.

Once you fill in any field, Address, City or town and Country are required.

  1. On the Billing address tab, select Remove billing address….
  2. Select Remove billing address.

Your invoices show your name, company and email address again. Emptying every field and selecting Save billing address does the same.

A message confirms Billing address saved. or Billing address removed., and the next invoice PDF you download shows the change.

An invoice PDF shows the billing address saved at the moment you download it, and that includes invoices from before the change. To keep a record of the address an invoice showed, keep the PDF you downloaded at the time.

A billing address and a VAT ID change no amounts. We add no tax to Coritan invoices, as the On your invoices card beside the form says.

The Country on the Profile tab is a separate setting that decides which ways to pay you are offered (Currencies and countries). Changing the country of your billing address does not change it.

Through the API, a team member with the Billing or Admin role can read and change the billing address of an account they work in. Members with the Technical or Read only role cannot open it, but a Read only member can download your invoices, which show it. Share your account with a team explains the roles.

Enter the first line of the address.
You filled in another field and left Address empty. An empty City or town shows Enter a city or town., and an empty Country shows Choose a country.
Enter a postcode of letters, digits, spaces and hyphens.
The postcode holds another character, such as # or /. Take it out.
Enter a VAT ID of letters and digits, such as DE123456789.
The VAT ID is shorter than four characters, or holds a character other than letters, digits, spaces, dots and hyphens. Enter it as it appears on your VAT registration.
Use 32 characters or fewer.
The VAT ID has more than 32 letters and digits.
You saved the billing address many times in the last hour. Wait a while and try again.
You can save the billing address 20 times an hour. Wait, then try again.
Someone saved the billing address at the same time. Reload the page and try again.
Two saves reached us at the same moment, for example from two browser tabs. Reload the page to see which one we kept, then try again.
Save billing address is greyed out
Nothing in the form has changed yet, or every field is empty and you have no billing address to remove.
Could not load your billing address
The tab did not load. Select Try again.
Could not save the billing address
The change did not save. The message under it gives the reason. Try again, and contact support if it keeps failing.

GET /auth/me/billing-profile returns the billing address:

Shell
curl https://api.coritan.com/api/v1/auth/me/billing-profile \
  -H "Authorization: Bearer $CORITAN_TOKEN"
JSON
{
  "legal_name": "Northwind Studio GmbH",
  "address_line1": "Friedrichstraße 68",
  "address_line2": null,
  "city": "Berlin",
  "region": null,
  "postcode": "10117",
  "country": "DE",
  "vat_id": "DE123456789",
  "country_name": "Germany",
  "vat_id_checked": false,
  "updated_at": "2026-09-12T09:30:00",
  "tax_enabled": false
}
legal_name
Who the invoices are made out to, or null to use your name and company.
address_line1, address_line2, city, region and postcode
The postal address. A saved billing address always has address_line1 and city, and the other three can be null.
country and country_name
The country, as a two-letter ISO 3166-1 code, and its name.
vat_id
Your VAT ID in capitals, without spaces, dots or hyphens, or null.
vat_id_checked
Whether we have checked the VAT ID. A new or changed VAT ID reads false.
updated_at
When the billing address last changed, or null while you have none.
tax_enabled
Whether we add tax to your invoices. While it is false, a VAT ID changes no amounts.

Without a billing address, every field is null and vat_id_checked is false.

PUT /auth/me/billing-profile replaces the whole billing address, so send every field you want to keep. A field you leave out, or send as null or an empty string, is cleared. The answer is the billing address, as above.

Shell
curl -X PUT https://api.coritan.com/api/v1/auth/me/billing-profile \
  -H "Authorization: Bearer $CORITAN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"legal_name": "Northwind Studio GmbH", "address_line1": "Friedrichstraße 68", "city": "Berlin", "postcode": "10117", "country": "DE", "vat_id": "DE 123 456 789"}'
  • With any field set, address_line1, city and country are required.
  • country is a code from the list that GET /payments/countries returns.
  • You can send back the fields the answer adds (country_name, vat_id_checked, updated_at and tax_enabled). We ignore them, so you cannot mark your own VAT ID as checked. Any other field answers 422, so a misspelt field cannot clear the field you meant.
  • Send every field empty, or {}, to remove the billing address.
Status Answer
422 One entry in detail for each field we refused, such as {"loc": ["body", "city"], "msg": "Enter a city or town.", "type": "value_error"}
422 Choose a country from the list., for a code that is not on the list
409 Someone saved the billing address at the same time. Reload the page and try again.
429 "error": "rate_limited", after 20 saves in an hour, with a Retry-After header

A team member with the Billing or Admin role sends the account's ID in the X-Coritan-Account header to read or save its billing address, as Share your account with a team shows. Another role answers 403 with "code": "role_refused".

API operations on this page

MethodPathWhat it does
GET/api/v1/auth/me/billing-profileWho the account's invoices are made out to: a legal name, a postal address and a VAT ID
PUT/api/v1/auth/me/billing-profileReplace the account's billing profile