> This page is for Spain Public Administration Flow.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://infonite.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://infonite.dev/_mcp/server.

# Properties

**Where it lives:** in the Spain Public Administration results, at `data.properties.es`. APIs with dedicated per-product results endpoints return this model directly.

One entry per property the person holds in the **Cadastre** (*Catastro*), read through the Carpeta Ciudadana in their name, with their consent: urban and rustic, owned outright or shared with others.

## What a property says

* **Where and what it is**: the cadastral reference, the address, its type (urban, rustic) and its use (residential, commercial, parking…).
* **What it is worth to the State**: the cadastral value (`assessed_value`), split into land and construction, and the year of that valuation.
* **Who holds it, and in what share**: see right below.

## Shared ownership

`owners` lists **every holder** of the property, not only the person who connected: a home bought with a partner comes back with both of them, each with their name, identity document and **share**.

`percentage` is a fraction: `0.5` is half, `0.59` is 59 %. So the person's real stake in a property is its value times their share, and a property they hold at 10 % is not a property they can offer as collateral on their own.

> **Note**
>
> **The Cadastre is a tax register, not the Land Registry.** It says who holds a property and what it is worth for tax purposes; it does not list mortgages, liens or seizures, which live in the Land Registry (*Registro de la Propiedad*). And a cadastral value is usually well below the market price. Read a property's debts from the [credit registry](/guides/data-models/credit-registry) and the [tax data](/guides/data-models/taxes)'s home loans.

### Schema (`ESOwnedPropertySchema`)

```yaml
components:
  schemas:
    _CurrencyAmount-Output:
      type: object
      additionalProperties:
        type: string
      title: _CurrencyAmount-Output
    PropertyOwnerSchema:
      type: object
      properties:
        name:
          type: string
          description: Full name of the owner.
        identifier:
          type: string
          description: Identification number of the owner.
        percentage:
          type: string
          format: number
          default: nan
          description: 'The owner''s share, as a fraction: 0.59 is 59 %.'
      required:
        - name
      title: PropertyOwnerSchema
    CadastralDownloadInfoSchema:
      type: object
      properties:
        cn:
          type: string
          description: Class of nature.
        cp:
          type: string
          description: Province code.
        cm:
          type: string
          description: Municipality code.
        pc1:
          type: string
          description: Cadastral plot 1.
        pc2:
          type: string
          description: Cadastral plot 2.
        car:
          type: string
          description: Cargo/charge identifier.
        cc1:
          type: string
          description: Control character 1.
        cc2:
          type: string
          description: Control character 2.
        cpo:
          type: string
          description: Postal code.
        cpa:
          type: string
          description: Postal code area.
        refCat:
          type: string
          description: Full cadastral reference.
      title: CadastralDownloadInfoSchema
    ESOwnedPropertySchema:
      type: object
      properties:
        product:
          type: string
          enum:
            - owned_property
        sub_family:
          type: string
          enum:
            - owned_property:es_owned_property
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched
        country:
          type: string
          format: country
          description: Country of the property.
        cadastral_reference:
          type: string
          description: Unique cadastral reference identifier.
        address:
          type: string
          description: Full address of the property.
        property_type:
          type: string
          description: Type of property (e.g., Urban, Rustic).
        property_use:
          type: string
          description: Main use of the property (e.g., Residential).
        assessment_year:
          type: string
          description: Year of the catastral assessment.
        assessed_value:
          $ref: '#/components/schemas/_CurrencyAmount-Output'
          description: >-
            Total cadastral value: the value for tax purposes, usually below the
            market price.
        land_value:
          $ref: '#/components/schemas/_CurrencyAmount-Output'
          description: Assessed land value.
        construction_value:
          $ref: '#/components/schemas/_CurrencyAmount-Output'
          description: Assessed construction value.
        owners:
          type: array
          items:
            $ref: '#/components/schemas/PropertyOwnerSchema'
          description: >-
            Every holder of the property, the person included, each with their
            share.
        cartography_link:
          type: string
          description: Link to the cartography map.
        download_info:
          $ref: '#/components/schemas/CadastralDownloadInfoSchema'
          description: Internal metadata for downloading documents.
      required:
        - product
        - sub_family
        - fetch_date
        - country
        - owners
      title: ESOwnedPropertySchema
```

## Owners

### Schema (`PropertyOwnerSchema`)

```yaml
components:
  schemas:
    PropertyOwnerSchema:
      type: object
      properties:
        name:
          type: string
          description: Full name of the owner.
        identifier:
          type: string
          description: Identification number of the owner.
        percentage:
          type: string
          format: number
          default: nan
          description: 'The owner''s share, as a fraction: 0.59 is 59 %.'
      required:
        - name
      title: PropertyOwnerSchema
```