# Addresses can be missing, and accept more characters

`issuer.address` is optional and is no longer filled with invented values, and one character set governs every address field.

Sep 3, 2026 · Breaking

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](/changelog/street-number-is-optional).
- **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}/customers` — every address field shares one character set

## Where to go next

- [Retrieve an invoice](/invoices/getCompanyInvoice)
- [Create a customer](/customers/createCompanyCustomer)
- [The street number is no longer required](/changelog/street-number-is-optional)

---

Full OpenAPI spec: https://docs.beel.es/api/openapi