Customer Profile
Where it lives: in the Spain Public Administration results, at data.customer.profile. APIs with dedicated per-product results endpoints return this model directly.
The customer profile is the identity the source has on file: names, identification documents, birth and nationality, contact details and declared situation. Use it to verify identity and to cross-check the data the user typed against what their institution knows about them.
One profile describes both persons and companies — type is the switch that tells you how
to read it, and each field’s description below says how its meaning changes (for a company,
birth_date is the incorporation date, nationality_country the registered seat,
residence_country the tax residence).
The customer's identity as the connected institution knows it: names, identification documents, birth and nationality, contact details (emails, phones, addresses) and declared situation (civil status, children, membership age). Use it to verify identity and to cross-check data the user typed against what their institution knows about them.
One profile describes both persons and companies — type tells you which one you are
reading. Some fields switch meaning accordingly (name, birth_date,
nationality_country, residence_country — each one says how); the strictly person-only
fields behave predictably for companies: name_extra and number_of_children come empty,
and gender / civil_status come as unknown.
The product type identifier. Always customer_information for this product.
The sub-family identifier: customer_information:user_profile, the customer's profile at
the institution.
The kind of customer: a person or a company. This is the switch that tells you how to read the rest of the profile.
The customer's identification documents as the institution registers them — for persons a DNI/NIE, passport or Social Security number; for companies the tax ID (CIF). Each entry carries its type, its value, and whether the value passed validation.
Persons only — gender as declared at the institution. unknown for companies, and for
persons whose source does not disclose it.
Persons only — civil status as declared at the institution. unknown for companies,
and for persons whose source does not disclose it.
For persons, the given name(s); for companies, the registered legal name (razón social).
Persons only — the rest of the legal name; Spanish institutions report both surnames here. Empty for companies.
How the institution addresses the customer when it differs from the legal name — a chosen or commercial name.
For persons, the date of birth; for companies, the date of incorporation, when the source provides it.
Country of birth, as a two-letter ISO code.
For persons, the country of nationality; for companies, the country of the registered seat. Two-letter ISO code.
For persons, the country of residence; for companies, the country of its tax residence. Two-letter ISO code.
Persons only — number of children, when the institution records it. Empty for companies.