Addresses can be missing, and accept more characters

ChangelogSep 3, 2026Breaking

Three changes to how addresses travel, all of them visible from outside.

The one that can break you: issuer.address leaves required. It is omitted when the company has not declared its address yet. It always arrived before — but it arrived made up: a newly registered company got street: "Sin especificar", postal_code: "00000", values nobody had ever entered, passing the contract as if they were data.

What else changed

issuer.address may now be absent. It affects issuer on invoice responses, previews included. If you read issuer.address.street directly, check that address exists first. If you print the issuer's address on a document, the gap is now visible instead of covered with false text — the fix is for the company to complete its fiscal address, which the issuing gate already requires, not for the API to invent one.
RecipientData.address was already optional and does not change. Customer.address is still required.
number was already announced separately and is unchanged here — see The street number is no longer required in an address.
One character set for every address field. street, city, province and country each accepted a slightly different set, so the same address was valid or not depending on which field it landed in — C/Xic de l'Anyé was rejected as a street and accepted as a city. There is now a single set, the union of everything any field already accepted: typographic apostrophes, parentheses and & work everywhere.
Nothing was renamed and no stored row was touched. An address that exists arrives exactly as before, and one that does not name a country is still read as Spanish — that is a declared convention, not invented data.

Endpoints

GET/v1/companies/{company_id}/invoices/{invoice_id}issuer.address is omitted when the company has not declared one
POST/v1/companies/{company_id}/customersevery address field shares one character set

Where to go next

Retrieve an invoice Create a customer The street number is no longer required