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.
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.
Before you begin
Section titled Before you begin- 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- In the sidebar, select Settings, then the Billing address tab.
- 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.
- Enter the Address, and Address line 2 if you need it.
- Enter the City or town. Add the State, county or region and the Postcode if your address has them.
- Choose the Country. Before you save a billing address, it starts as your billing country from the Profile tab.
- 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 789becomesGB123456789. - Select Save billing address.
Once you fill in any field, Address, City or town and Country are required.
Remove your billing address
Section titled Remove your billing address- On the Billing address tab, select Remove billing address….
- 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.
Result
Section titled ResultA 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.
Team members
Section titled Team membersThrough 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.
Troubleshooting
Section titled TroubleshootingEnter 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 showsChoose 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.
Related
Section titled RelatedWith the API
Section titled With the APIRead the billing address
Section titled Read the billing addressGET /auth/me/billing-profile returns the billing address:
curl https://api.coritan.com/api/v1/auth/me/billing-profile \
-H "Authorization: Bearer $CORITAN_TOKEN"
{
"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
nullto use your name and company. address_line1,address_line2,city,regionandpostcode- The postal address. A saved billing address always has
address_line1andcity, and the other three can benull. countryandcountry_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
nullwhile 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.
Save the billing address
Section titled Save the billing addressPUT /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.
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,cityandcountryare required. countryis a code from the list thatGET /payments/countriesreturns.- You can send back the fields the answer adds (
country_name,vat_id_checked,updated_atandtax_enabled). We ignore them, so you cannot mark your own VAT ID as checked. Any other field answers422, 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
| Method | Path | What it does |
|---|---|---|
GET | /api/v1/auth/me/billing-profile | Who the account's invoices are made out to: a legal name, a postal address and a VAT ID |
PUT | /api/v1/auth/me/billing-profile | Replace the account's billing profile |