> 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.

# Investments

**Where it lives:** at `investments` in the **Financial Position** — with `accounts`, `stocks`, `funds` and `pensions` inside it — and one by one from their own endpoints.

### Schema (`InvestmentsFamily`)

```yaml
components:
  schemas:
    InvestmentAccountSchemaDataEnrichment:
      type: string
      enum:
        - skipped
        - pending
        - processing
        - ready
        - failed
      description: >-
        Data enrichment status. Indicates whether the product has been enriched
        with additional data. If not, the product will be filled with generic
        data.
      title: InvestmentAccountSchemaDataEnrichment
    InvestmentAccountSchemaIdentifier:
      oneOf:
        - type: object
          properties:
            type:
              type: string
              enum:
                - clabe
              description: 'Discriminator value: clabe'
            value:
              type: string
              format: clabe
              description: Clave Bancaria Estandarizada
            masked:
              type: string
              minLength: 1
              maxLength: 19
              description: Partial Clabe
            entity_country:
              type: string
              description: Bank Country
            entity_code:
              type: string
              description: Bank code
            entity_office:
              type: string
              description: Bank office
            control_digits:
              type: string
              description: Control digit
          required:
            - type
            - value
            - masked
            - entity_country
            - entity_code
            - entity_office
            - control_digits
          description: Clave Bancaria Estandarizada
        - type: object
          properties:
            type:
              type: string
              enum:
                - generic
              description: 'Discriminator value: generic'
            value:
              type: string
              description: Identifier
            entity_country:
              type: string
              format: country
              description: Entity country
            entity_code:
              type: string
              description: Entity code
            entity_office:
              type: string
              description: Entity office
            control_digits:
              type: string
              description: Control digits
          required:
            - type
            - value
          description: Generic account identifier
        - type: object
          properties:
            type:
              type: string
              enum:
                - iban
              description: 'Discriminator value: iban'
            value:
              type: string
              format: iban
              description: International Bank Account Number
            masked:
              type: string
              minLength: 1
              maxLength: 34
              description: Partial IBAN
            entity_country:
              type: string
              description: Bank Country
            entity_code:
              type: string
              description: Bank code
            entity_office:
              type: string
              description: Bank office
            control_digits:
              type: string
              description: Control digits
          required:
            - type
            - value
            - masked
            - entity_country
            - entity_code
            - entity_office
            - control_digits
          description: International Bank Account Number
      discriminator:
        propertyName: type
      description: Account identifier
      title: InvestmentAccountSchemaIdentifier
    CustomerSegment:
      type: string
      enum:
        - not_assigned
        - personal
        - business
        - corporate
        - private
        - retail
      title: CustomerSegment
    InfoniteSchemasUtilsCurrencyAmountSchema1Currency:
      oneOf:
        - type: string
          format: currency
        - type: string
          enum:
            - '***'
      description: >-
        Three-letter ISO currency code — or `***` when the source did not
        disclose the currency.
      title: InfoniteSchemasUtilsCurrencyAmountSchema1Currency
    infonite__schemas__utils__CurrencyAmountSchema__1:
      type: object
      properties:
        currency:
          $ref: >-
            #/components/schemas/InfoniteSchemasUtilsCurrencyAmountSchema1Currency
          description: >-
            Three-letter ISO currency code — or `***` when the source did not
            disclose the currency.
        amount:
          type: string
          format: number
          description: Decimal number with 2 digits precision
      required:
        - currency
        - amount
      description: A monetary amount together with its currency.
      title: infonite__schemas__utils__CurrencyAmountSchema__1
    InfonitePydanticFieldsCommonRate2Unit:
      oneOf:
        - type: string
          enum:
            - '%'
        - type: string
          format: currency
      title: InfonitePydanticFieldsCommonRate2Unit
    infonite__pydantic__fields__common___Rate__2:
      type: object
      properties:
        value:
          type: string
          format: number
          description: Decimal number with 2 digits precision
        unit:
          $ref: '#/components/schemas/InfonitePydanticFieldsCommonRate2Unit'
          default: '%'
        description:
          type:
            - string
            - 'null'
      title: infonite__pydantic__fields__common___Rate__2
    InvestmentAccountSchema:
      type: object
      properties:
        id:
          type: string
          format: object-id
          description: >-
            Product ID for the current execution. Note: it may change between
            executions.
        product:
          type: string
          enum:
            - financial_account
        sub_family:
          type: string
          enum:
            - financial_account:investments
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched
        data_enrichment:
          $ref: '#/components/schemas/InvestmentAccountSchemaDataEnrichment'
          description: >-
            Data enrichment status. Indicates whether the product has been
            enriched with additional data. If not, the product will be filled
            with generic data.
        identifier:
          $ref: '#/components/schemas/InvestmentAccountSchemaIdentifier'
          description: Account identifier
        customer_segment:
          $ref: '#/components/schemas/CustomerSegment'
        product_name:
          type: string
          description: Product name
        product_alias:
          type: string
          description: Product alias
        product_description:
          type: string
          description: Product Description
        opening_date:
          type: string
          format: date
          description: Account opening date
        valuation_date:
          type: string
          format: date
          description: Valuation date
        valuation:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: >-
            Valuation of the assets held in the account. (Deprecated, use
            `balance` instead)
        appreciation:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Monetary appreciation of the assets held in the account
        performance:
          $ref: '#/components/schemas/infonite__pydantic__fields__common___Rate__2'
          description: Account performance
      required:
        - id
        - product
        - sub_family
        - fetch_date
        - data_enrichment
        - identifier
        - customer_segment
        - product_name
      title: InvestmentAccountSchema
    GenericIdentifierSchema:
      type: object
      properties:
        value:
          type: string
          description: Identifier
        entity_country:
          type: string
          format: country
          description: Entity country
        entity_code:
          type: string
          description: Entity code
        entity_office:
          type: string
          description: Entity office
        control_digits:
          type: string
          description: Control digits
      required:
        - value
      description: Generic account identifier
      title: GenericIdentifierSchema
    InvestmentStockSchemaAccount:
      oneOf:
        - type: object
          properties:
            type:
              type: string
              enum:
                - clabe
              description: 'Discriminator value: clabe'
            value:
              type: string
              format: clabe
              description: Clave Bancaria Estandarizada
            masked:
              type: string
              minLength: 1
              maxLength: 19
              description: Partial Clabe
            entity_country:
              type: string
              description: Bank Country
            entity_code:
              type: string
              description: Bank code
            entity_office:
              type: string
              description: Bank office
            control_digits:
              type: string
              description: Control digit
          required:
            - type
            - value
            - masked
            - entity_country
            - entity_code
            - entity_office
            - control_digits
          description: Clave Bancaria Estandarizada
        - type: object
          properties:
            type:
              type: string
              enum:
                - generic
              description: 'Discriminator value: generic'
            value:
              type: string
              description: Identifier
            entity_country:
              type: string
              format: country
              description: Entity country
            entity_code:
              type: string
              description: Entity code
            entity_office:
              type: string
              description: Entity office
            control_digits:
              type: string
              description: Control digits
          required:
            - type
            - value
          description: Generic account identifier
        - type: object
          properties:
            type:
              type: string
              enum:
                - iban
              description: 'Discriminator value: iban'
            value:
              type: string
              format: iban
              description: International Bank Account Number
            masked:
              type: string
              minLength: 1
              maxLength: 34
              description: Partial IBAN
            entity_country:
              type: string
              description: Bank Country
            entity_code:
              type: string
              description: Bank code
            entity_office:
              type: string
              description: Bank office
            control_digits:
              type: string
              description: Control digits
          required:
            - type
            - value
            - masked
            - entity_country
            - entity_code
            - entity_office
            - control_digits
          description: International Bank Account Number
      discriminator:
        propertyName: type
      description: Account identifier
      title: InvestmentStockSchemaAccount
    InfoniteSchemasUtilsCurrencyAmountSchema2Currency:
      oneOf:
        - type: string
          format: currency
        - type: string
          enum:
            - '***'
      description: >-
        Three-letter ISO currency code — or `***` when the source did not
        disclose the currency.
      title: InfoniteSchemasUtilsCurrencyAmountSchema2Currency
    infonite__schemas__utils__CurrencyAmountSchema__2:
      type: object
      properties:
        currency:
          $ref: >-
            #/components/schemas/InfoniteSchemasUtilsCurrencyAmountSchema2Currency
          description: >-
            Three-letter ISO currency code — or `***` when the source did not
            disclose the currency.
        amount:
          type: string
          format: number
          default: nan
          description: Decimal number with 6 digits precision
      required:
        - currency
      title: infonite__schemas__utils__CurrencyAmountSchema__2
    InfonitePydanticFieldsCommonRate1Unit:
      oneOf:
        - type: string
          enum:
            - '%'
        - type: string
          format: currency
      title: InfonitePydanticFieldsCommonRate1Unit
    infonite__pydantic__fields__common___Rate__1:
      type: object
      properties:
        value:
          type: string
          format: number
          default: NaN
          description: Decimal number with 6 digits precision
        unit:
          $ref: '#/components/schemas/InfonitePydanticFieldsCommonRate1Unit'
          default: '%'
        description:
          type:
            - string
            - 'null'
      title: infonite__pydantic__fields__common___Rate__1
    InvestmentStockSchema:
      type: object
      properties:
        id:
          type: string
          format: object-id
          description: >-
            Product ID for the current execution. Note: it may change between
            executions.
        product:
          type: string
          enum:
            - investment_asset
        sub_family:
          type: string
          enum:
            - investment_asset:stock
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched
        contract:
          $ref: '#/components/schemas/GenericIdentifierSchema'
          description: Contract if present
        account:
          $ref: '#/components/schemas/InvestmentStockSchemaAccount'
          description: Account identifier
        customer_segment:
          $ref: '#/components/schemas/CustomerSegment'
        product_name:
          type: string
          description: Product name
        product_alias:
          type: string
          description: Product alias
        product_description:
          type: string
          description: Product Description
        isin:
          type: string
          description: ISIN code
        ticker:
          type: string
          description: Ticker
        market:
          type: string
          description: Market
        category:
          type: string
          description: Category
        unit_price:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__2
          description: Unit price
        quantity:
          type: string
          format: number
          default: nan
          description: The number of units of a financial instrument held by the account.
        valuation:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: The monetary value of a financial instrument held by the account.
        valuation_date:
          type: string
          format: date
          description: Valuation date
        appreciation:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: >-
            The monetary value of the appreciation of a financial instrument
            held by the account.
        performance:
          $ref: '#/components/schemas/infonite__pydantic__fields__common___Rate__1'
          description: Performance
      required:
        - id
        - product
        - sub_family
        - fetch_date
        - account
        - customer_segment
        - product_name
      title: InvestmentStockSchema
    InvestmentFundSchemaSubFamily:
      type: string
      enum:
        - investment_asset:fund
        - investment_asset:etf
        - investment_asset:mutual
        - investment_asset:closed
      title: InvestmentFundSchemaSubFamily
    InvestmentFundSchemaAccount:
      oneOf:
        - type: object
          properties:
            type:
              type: string
              enum:
                - clabe
              description: 'Discriminator value: clabe'
            value:
              type: string
              format: clabe
              description: Clave Bancaria Estandarizada
            masked:
              type: string
              minLength: 1
              maxLength: 19
              description: Partial Clabe
            entity_country:
              type: string
              description: Bank Country
            entity_code:
              type: string
              description: Bank code
            entity_office:
              type: string
              description: Bank office
            control_digits:
              type: string
              description: Control digit
          required:
            - type
            - value
            - masked
            - entity_country
            - entity_code
            - entity_office
            - control_digits
          description: Clave Bancaria Estandarizada
        - type: object
          properties:
            type:
              type: string
              enum:
                - generic
              description: 'Discriminator value: generic'
            value:
              type: string
              description: Identifier
            entity_country:
              type: string
              format: country
              description: Entity country
            entity_code:
              type: string
              description: Entity code
            entity_office:
              type: string
              description: Entity office
            control_digits:
              type: string
              description: Control digits
          required:
            - type
            - value
          description: Generic account identifier
        - type: object
          properties:
            type:
              type: string
              enum:
                - iban
              description: 'Discriminator value: iban'
            value:
              type: string
              format: iban
              description: International Bank Account Number
            masked:
              type: string
              minLength: 1
              maxLength: 34
              description: Partial IBAN
            entity_country:
              type: string
              description: Bank Country
            entity_code:
              type: string
              description: Bank code
            entity_office:
              type: string
              description: Bank office
            control_digits:
              type: string
              description: Control digits
          required:
            - type
            - value
            - masked
            - entity_country
            - entity_code
            - entity_office
            - control_digits
          description: International Bank Account Number
      discriminator:
        propertyName: type
      description: Account identifier
      title: InvestmentFundSchemaAccount
    InvestmentFundSchema:
      type: object
      properties:
        id:
          type: string
          format: object-id
          description: >-
            Product ID for the current execution. Note: it may change between
            executions.
        product:
          type: string
          enum:
            - investment_asset
        sub_family:
          $ref: '#/components/schemas/InvestmentFundSchemaSubFamily'
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched
        contract:
          $ref: '#/components/schemas/GenericIdentifierSchema'
          description: Contract if present
        account:
          $ref: '#/components/schemas/InvestmentFundSchemaAccount'
          description: Account identifier
        customer_segment:
          $ref: '#/components/schemas/CustomerSegment'
        product_name:
          type: string
          description: Product name
        product_alias:
          type: string
          description: Product alias
        product_description:
          type: string
          description: Product Description
        isin:
          type: string
          description: ISIN code
        ticker:
          type: string
          description: Ticker
        market:
          type: string
          description: Market
        category:
          type: string
          description: Category
        unit_price:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__2
          description: Unit price
        quantity:
          type: string
          format: number
          default: nan
          description: The number of units of a financial instrument held by the account.
        valuation:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: The monetary value of a financial instrument held by the account.
        valuation_date:
          type: string
          format: date
          description: Valuation date
        appreciation:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: >-
            The monetary value of the appreciation of a financial instrument
            held by the account.
        performance:
          $ref: '#/components/schemas/infonite__pydantic__fields__common___Rate__1'
          description: Performance
      required:
        - id
        - product
        - sub_family
        - fetch_date
        - account
        - customer_segment
        - product_name
      title: InvestmentFundSchema
    PensionPlanType:
      type: string
      enum:
        - pension_plan:pension
      title: PensionPlanType
    PensionPlanSchemaIdentifier:
      oneOf:
        - type: object
          properties:
            type:
              type: string
              enum:
                - generic
              description: 'Discriminator value: generic'
            value:
              type: string
              description: Identifier
            entity_country:
              type: string
              format: country
              description: Entity country
            entity_code:
              type: string
              description: Entity code
            entity_office:
              type: string
              description: Entity office
            control_digits:
              type: string
              description: Control digits
          required:
            - type
            - value
          description: Generic account identifier
      discriminator:
        propertyName: type
      description: Plan number
      title: PensionPlanSchemaIdentifier
    PensionPlanSchemaLinkedAccount:
      oneOf:
        - type: object
          properties:
            type:
              type: string
              enum:
                - clabe
              description: 'Discriminator value: clabe'
            value:
              type: string
              format: clabe
              description: Clave Bancaria Estandarizada
            masked:
              type: string
              minLength: 1
              maxLength: 19
              description: Partial Clabe
            entity_country:
              type: string
              description: Bank Country
            entity_code:
              type: string
              description: Bank code
            entity_office:
              type: string
              description: Bank office
            control_digits:
              type: string
              description: Control digit
          required:
            - type
            - value
            - masked
            - entity_country
            - entity_code
            - entity_office
            - control_digits
          description: Clave Bancaria Estandarizada
        - type: object
          properties:
            type:
              type: string
              enum:
                - generic
              description: 'Discriminator value: generic'
            value:
              type: string
              description: Identifier
            entity_country:
              type: string
              format: country
              description: Entity country
            entity_code:
              type: string
              description: Entity code
            entity_office:
              type: string
              description: Entity office
            control_digits:
              type: string
              description: Control digits
          required:
            - type
            - value
          description: Generic account identifier
        - type: object
          properties:
            type:
              type: string
              enum:
                - iban
              description: 'Discriminator value: iban'
            value:
              type: string
              format: iban
              description: International Bank Account Number
            masked:
              type: string
              minLength: 1
              maxLength: 34
              description: Partial IBAN
            entity_country:
              type: string
              description: Bank Country
            entity_code:
              type: string
              description: Bank code
            entity_office:
              type: string
              description: Bank office
            control_digits:
              type: string
              description: Control digits
          required:
            - type
            - value
            - masked
            - entity_country
            - entity_code
            - entity_office
            - control_digits
          description: International Bank Account Number
      discriminator:
        propertyName: type
      description: Account identifier
      title: PensionPlanSchemaLinkedAccount
    InfoniteSchemasUtilsCurrencyAmountSchema3Currency:
      oneOf:
        - type: string
          format: currency
        - type: string
          enum:
            - '***'
      description: >-
        Three-letter ISO currency code — or `***` when the source did not
        disclose the currency.
      title: InfoniteSchemasUtilsCurrencyAmountSchema3Currency
    infonite__schemas__utils__CurrencyAmountSchema__3:
      type: object
      properties:
        currency:
          $ref: >-
            #/components/schemas/InfoniteSchemasUtilsCurrencyAmountSchema3Currency
          description: >-
            Three-letter ISO currency code — or `***` when the source did not
            disclose the currency.
        amount:
          type: string
          format: number
          default: nan
          description: Decimal number with 6 digits precision
      required:
        - currency
      title: infonite__schemas__utils__CurrencyAmountSchema__3
    InfoniteSchemasUtilsCurrencyAmountSchema4Currency:
      oneOf:
        - type: string
          format: currency
        - type: string
          enum:
            - '***'
      description: >-
        Three-letter ISO currency code — or `***` when the source did not
        disclose the currency.
      title: InfoniteSchemasUtilsCurrencyAmountSchema4Currency
    infonite__schemas__utils__CurrencyAmountSchema__4:
      type: object
      properties:
        currency:
          $ref: >-
            #/components/schemas/InfoniteSchemasUtilsCurrencyAmountSchema4Currency
          description: >-
            Three-letter ISO currency code — or `***` when the source did not
            disclose the currency.
        amount:
          type: string
          format: number
          default: nan
          description: Decimal number with 6 digits precision
      required:
        - currency
      title: infonite__schemas__utils__CurrencyAmountSchema__4
    PensionPlanSchema:
      type: object
      properties:
        id:
          type: string
          format: object-id
          description: >-
            Product ID for the current execution. Note: it may change between
            executions.
        product:
          type: string
          enum:
            - pension_plan
        sub_family:
          $ref: '#/components/schemas/PensionPlanType'
          description: Pension plan type
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched
        identifier:
          $ref: '#/components/schemas/PensionPlanSchemaIdentifier'
          description: Plan number
        linked_account:
          $ref: '#/components/schemas/PensionPlanSchemaLinkedAccount'
          description: Account identifier
        customer_segment:
          $ref: '#/components/schemas/CustomerSegment'
        product_name:
          type: string
          description: Product name
        product_alias:
          type: string
          description: Product alias
        product_description:
          type: string
          description: Product Description
        category:
          type: string
          description: Plan Category
        begin_date:
          type: string
          format: date
          description: Begin date
        end_date:
          type: string
          format: date
          description: End Date
        total_contribution:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Total contribution
        year_to_date_contribution:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Year to date contribution
        unit_price:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__3
          description: Unit price
        quantity:
          type: string
          format: number
          default: nan
          description: The number of units of a financial instrument held by the account.
        valuation:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: The monetary value of a financial instrument held by the account.
        valuation_date:
          type: string
          format: date
          description: Valuation date
        performance:
          $ref: '#/components/schemas/infonite__pydantic__fields__common___Rate__1'
          description: Total Performance
        performance_year_to_date:
          $ref: '#/components/schemas/infonite__pydantic__fields__common___Rate__1'
          description: Year to date performance
        performance_last_12_months:
          $ref: '#/components/schemas/infonite__pydantic__fields__common___Rate__1'
          description: Last 12 months performance
        appreciation:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__4
          description: >-
            The monetary value of the appreciation of a financial instrument
            held by the account.
      required:
        - id
        - product
        - sub_family
        - fetch_date
        - identifier
        - customer_segment
        - product_name
      title: PensionPlanSchema
    InvestmentsFamily:
      type: object
      properties:
        accounts:
          type: array
          items:
            $ref: '#/components/schemas/InvestmentAccountSchema'
          description: Investment accounts
        stocks:
          type: array
          items:
            $ref: '#/components/schemas/InvestmentStockSchema'
          description: Investment stocks
        funds:
          type: array
          items:
            $ref: '#/components/schemas/InvestmentFundSchema'
          description: Investment funds
        pensions:
          type: array
          items:
            $ref: '#/components/schemas/PensionPlanSchema'
          description: Pension plans
      title: InvestmentsFamily
```

## Investment accounts

The wrapper: the securities account the holdings sit in, with its own valuation and performance.

### Schema (`InvestmentAccountSchema`)

```yaml
components:
  schemas:
    InvestmentAccountSchemaDataEnrichment:
      type: string
      enum:
        - skipped
        - pending
        - processing
        - ready
        - failed
      description: >-
        Data enrichment status. Indicates whether the product has been enriched
        with additional data. If not, the product will be filled with generic
        data.
      title: InvestmentAccountSchemaDataEnrichment
    InvestmentAccountSchemaIdentifier:
      oneOf:
        - type: object
          properties:
            type:
              type: string
              enum:
                - clabe
              description: 'Discriminator value: clabe'
            value:
              type: string
              format: clabe
              description: Clave Bancaria Estandarizada
            masked:
              type: string
              minLength: 1
              maxLength: 19
              description: Partial Clabe
            entity_country:
              type: string
              description: Bank Country
            entity_code:
              type: string
              description: Bank code
            entity_office:
              type: string
              description: Bank office
            control_digits:
              type: string
              description: Control digit
          required:
            - type
            - value
            - masked
            - entity_country
            - entity_code
            - entity_office
            - control_digits
          description: Clave Bancaria Estandarizada
        - type: object
          properties:
            type:
              type: string
              enum:
                - generic
              description: 'Discriminator value: generic'
            value:
              type: string
              description: Identifier
            entity_country:
              type: string
              format: country
              description: Entity country
            entity_code:
              type: string
              description: Entity code
            entity_office:
              type: string
              description: Entity office
            control_digits:
              type: string
              description: Control digits
          required:
            - type
            - value
          description: Generic account identifier
        - type: object
          properties:
            type:
              type: string
              enum:
                - iban
              description: 'Discriminator value: iban'
            value:
              type: string
              format: iban
              description: International Bank Account Number
            masked:
              type: string
              minLength: 1
              maxLength: 34
              description: Partial IBAN
            entity_country:
              type: string
              description: Bank Country
            entity_code:
              type: string
              description: Bank code
            entity_office:
              type: string
              description: Bank office
            control_digits:
              type: string
              description: Control digits
          required:
            - type
            - value
            - masked
            - entity_country
            - entity_code
            - entity_office
            - control_digits
          description: International Bank Account Number
      discriminator:
        propertyName: type
      description: Account identifier
      title: InvestmentAccountSchemaIdentifier
    CustomerSegment:
      type: string
      enum:
        - not_assigned
        - personal
        - business
        - corporate
        - private
        - retail
      title: CustomerSegment
    InfoniteSchemasUtilsCurrencyAmountSchema1Currency:
      oneOf:
        - type: string
          format: currency
        - type: string
          enum:
            - '***'
      description: >-
        Three-letter ISO currency code — or `***` when the source did not
        disclose the currency.
      title: InfoniteSchemasUtilsCurrencyAmountSchema1Currency
    infonite__schemas__utils__CurrencyAmountSchema__1:
      type: object
      properties:
        currency:
          $ref: >-
            #/components/schemas/InfoniteSchemasUtilsCurrencyAmountSchema1Currency
          description: >-
            Three-letter ISO currency code — or `***` when the source did not
            disclose the currency.
        amount:
          type: string
          format: number
          description: Decimal number with 2 digits precision
      required:
        - currency
        - amount
      description: A monetary amount together with its currency.
      title: infonite__schemas__utils__CurrencyAmountSchema__1
    InfonitePydanticFieldsCommonRate2Unit:
      oneOf:
        - type: string
          enum:
            - '%'
        - type: string
          format: currency
      title: InfonitePydanticFieldsCommonRate2Unit
    infonite__pydantic__fields__common___Rate__2:
      type: object
      properties:
        value:
          type: string
          format: number
          description: Decimal number with 2 digits precision
        unit:
          $ref: '#/components/schemas/InfonitePydanticFieldsCommonRate2Unit'
          default: '%'
        description:
          type:
            - string
            - 'null'
      title: infonite__pydantic__fields__common___Rate__2
    InvestmentAccountSchema:
      type: object
      properties:
        id:
          type: string
          format: object-id
          description: >-
            Product ID for the current execution. Note: it may change between
            executions.
        product:
          type: string
          enum:
            - financial_account
        sub_family:
          type: string
          enum:
            - financial_account:investments
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched
        data_enrichment:
          $ref: '#/components/schemas/InvestmentAccountSchemaDataEnrichment'
          description: >-
            Data enrichment status. Indicates whether the product has been
            enriched with additional data. If not, the product will be filled
            with generic data.
        identifier:
          $ref: '#/components/schemas/InvestmentAccountSchemaIdentifier'
          description: Account identifier
        customer_segment:
          $ref: '#/components/schemas/CustomerSegment'
        product_name:
          type: string
          description: Product name
        product_alias:
          type: string
          description: Product alias
        product_description:
          type: string
          description: Product Description
        opening_date:
          type: string
          format: date
          description: Account opening date
        valuation_date:
          type: string
          format: date
          description: Valuation date
        valuation:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: >-
            Valuation of the assets held in the account. (Deprecated, use
            `balance` instead)
        appreciation:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Monetary appreciation of the assets held in the account
        performance:
          $ref: '#/components/schemas/infonite__pydantic__fields__common___Rate__2'
          description: Account performance
      required:
        - id
        - product
        - sub_family
        - fetch_date
        - data_enrichment
        - identifier
        - customer_segment
        - product_name
      title: InvestmentAccountSchema
```

## Stocks

Listed holdings, identified by `isin` and `ticker`, with the quantity held and the price used to value it.

### Schema (`InvestmentStockSchema`)

```yaml
components:
  schemas:
    GenericIdentifierSchema:
      type: object
      properties:
        value:
          type: string
          description: Identifier
        entity_country:
          type: string
          format: country
          description: Entity country
        entity_code:
          type: string
          description: Entity code
        entity_office:
          type: string
          description: Entity office
        control_digits:
          type: string
          description: Control digits
      required:
        - value
      description: Generic account identifier
      title: GenericIdentifierSchema
    InvestmentStockSchemaAccount:
      oneOf:
        - type: object
          properties:
            type:
              type: string
              enum:
                - clabe
              description: 'Discriminator value: clabe'
            value:
              type: string
              format: clabe
              description: Clave Bancaria Estandarizada
            masked:
              type: string
              minLength: 1
              maxLength: 19
              description: Partial Clabe
            entity_country:
              type: string
              description: Bank Country
            entity_code:
              type: string
              description: Bank code
            entity_office:
              type: string
              description: Bank office
            control_digits:
              type: string
              description: Control digit
          required:
            - type
            - value
            - masked
            - entity_country
            - entity_code
            - entity_office
            - control_digits
          description: Clave Bancaria Estandarizada
        - type: object
          properties:
            type:
              type: string
              enum:
                - generic
              description: 'Discriminator value: generic'
            value:
              type: string
              description: Identifier
            entity_country:
              type: string
              format: country
              description: Entity country
            entity_code:
              type: string
              description: Entity code
            entity_office:
              type: string
              description: Entity office
            control_digits:
              type: string
              description: Control digits
          required:
            - type
            - value
          description: Generic account identifier
        - type: object
          properties:
            type:
              type: string
              enum:
                - iban
              description: 'Discriminator value: iban'
            value:
              type: string
              format: iban
              description: International Bank Account Number
            masked:
              type: string
              minLength: 1
              maxLength: 34
              description: Partial IBAN
            entity_country:
              type: string
              description: Bank Country
            entity_code:
              type: string
              description: Bank code
            entity_office:
              type: string
              description: Bank office
            control_digits:
              type: string
              description: Control digits
          required:
            - type
            - value
            - masked
            - entity_country
            - entity_code
            - entity_office
            - control_digits
          description: International Bank Account Number
      discriminator:
        propertyName: type
      description: Account identifier
      title: InvestmentStockSchemaAccount
    CustomerSegment:
      type: string
      enum:
        - not_assigned
        - personal
        - business
        - corporate
        - private
        - retail
      title: CustomerSegment
    InfoniteSchemasUtilsCurrencyAmountSchema2Currency:
      oneOf:
        - type: string
          format: currency
        - type: string
          enum:
            - '***'
      description: >-
        Three-letter ISO currency code — or `***` when the source did not
        disclose the currency.
      title: InfoniteSchemasUtilsCurrencyAmountSchema2Currency
    infonite__schemas__utils__CurrencyAmountSchema__2:
      type: object
      properties:
        currency:
          $ref: >-
            #/components/schemas/InfoniteSchemasUtilsCurrencyAmountSchema2Currency
          description: >-
            Three-letter ISO currency code — or `***` when the source did not
            disclose the currency.
        amount:
          type: string
          format: number
          default: nan
          description: Decimal number with 6 digits precision
      required:
        - currency
      title: infonite__schemas__utils__CurrencyAmountSchema__2
    InfoniteSchemasUtilsCurrencyAmountSchema1Currency:
      oneOf:
        - type: string
          format: currency
        - type: string
          enum:
            - '***'
      description: >-
        Three-letter ISO currency code — or `***` when the source did not
        disclose the currency.
      title: InfoniteSchemasUtilsCurrencyAmountSchema1Currency
    infonite__schemas__utils__CurrencyAmountSchema__1:
      type: object
      properties:
        currency:
          $ref: >-
            #/components/schemas/InfoniteSchemasUtilsCurrencyAmountSchema1Currency
          description: >-
            Three-letter ISO currency code — or `***` when the source did not
            disclose the currency.
        amount:
          type: string
          format: number
          description: Decimal number with 2 digits precision
      required:
        - currency
        - amount
      description: A monetary amount together with its currency.
      title: infonite__schemas__utils__CurrencyAmountSchema__1
    InfonitePydanticFieldsCommonRate1Unit:
      oneOf:
        - type: string
          enum:
            - '%'
        - type: string
          format: currency
      title: InfonitePydanticFieldsCommonRate1Unit
    infonite__pydantic__fields__common___Rate__1:
      type: object
      properties:
        value:
          type: string
          format: number
          default: NaN
          description: Decimal number with 6 digits precision
        unit:
          $ref: '#/components/schemas/InfonitePydanticFieldsCommonRate1Unit'
          default: '%'
        description:
          type:
            - string
            - 'null'
      title: infonite__pydantic__fields__common___Rate__1
    InvestmentStockSchema:
      type: object
      properties:
        id:
          type: string
          format: object-id
          description: >-
            Product ID for the current execution. Note: it may change between
            executions.
        product:
          type: string
          enum:
            - investment_asset
        sub_family:
          type: string
          enum:
            - investment_asset:stock
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched
        contract:
          $ref: '#/components/schemas/GenericIdentifierSchema'
          description: Contract if present
        account:
          $ref: '#/components/schemas/InvestmentStockSchemaAccount'
          description: Account identifier
        customer_segment:
          $ref: '#/components/schemas/CustomerSegment'
        product_name:
          type: string
          description: Product name
        product_alias:
          type: string
          description: Product alias
        product_description:
          type: string
          description: Product Description
        isin:
          type: string
          description: ISIN code
        ticker:
          type: string
          description: Ticker
        market:
          type: string
          description: Market
        category:
          type: string
          description: Category
        unit_price:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__2
          description: Unit price
        quantity:
          type: string
          format: number
          default: nan
          description: The number of units of a financial instrument held by the account.
        valuation:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: The monetary value of a financial instrument held by the account.
        valuation_date:
          type: string
          format: date
          description: Valuation date
        appreciation:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: >-
            The monetary value of the appreciation of a financial instrument
            held by the account.
        performance:
          $ref: '#/components/schemas/infonite__pydantic__fields__common___Rate__1'
          description: Performance
      required:
        - id
        - product
        - sub_family
        - fetch_date
        - account
        - customer_segment
        - product_name
      title: InvestmentStockSchema
```

## Funds

### Schema (`InvestmentFundSchema`)

```yaml
components:
  schemas:
    InvestmentFundSchemaSubFamily:
      type: string
      enum:
        - investment_asset:fund
        - investment_asset:etf
        - investment_asset:mutual
        - investment_asset:closed
      title: InvestmentFundSchemaSubFamily
    GenericIdentifierSchema:
      type: object
      properties:
        value:
          type: string
          description: Identifier
        entity_country:
          type: string
          format: country
          description: Entity country
        entity_code:
          type: string
          description: Entity code
        entity_office:
          type: string
          description: Entity office
        control_digits:
          type: string
          description: Control digits
      required:
        - value
      description: Generic account identifier
      title: GenericIdentifierSchema
    InvestmentFundSchemaAccount:
      oneOf:
        - type: object
          properties:
            type:
              type: string
              enum:
                - clabe
              description: 'Discriminator value: clabe'
            value:
              type: string
              format: clabe
              description: Clave Bancaria Estandarizada
            masked:
              type: string
              minLength: 1
              maxLength: 19
              description: Partial Clabe
            entity_country:
              type: string
              description: Bank Country
            entity_code:
              type: string
              description: Bank code
            entity_office:
              type: string
              description: Bank office
            control_digits:
              type: string
              description: Control digit
          required:
            - type
            - value
            - masked
            - entity_country
            - entity_code
            - entity_office
            - control_digits
          description: Clave Bancaria Estandarizada
        - type: object
          properties:
            type:
              type: string
              enum:
                - generic
              description: 'Discriminator value: generic'
            value:
              type: string
              description: Identifier
            entity_country:
              type: string
              format: country
              description: Entity country
            entity_code:
              type: string
              description: Entity code
            entity_office:
              type: string
              description: Entity office
            control_digits:
              type: string
              description: Control digits
          required:
            - type
            - value
          description: Generic account identifier
        - type: object
          properties:
            type:
              type: string
              enum:
                - iban
              description: 'Discriminator value: iban'
            value:
              type: string
              format: iban
              description: International Bank Account Number
            masked:
              type: string
              minLength: 1
              maxLength: 34
              description: Partial IBAN
            entity_country:
              type: string
              description: Bank Country
            entity_code:
              type: string
              description: Bank code
            entity_office:
              type: string
              description: Bank office
            control_digits:
              type: string
              description: Control digits
          required:
            - type
            - value
            - masked
            - entity_country
            - entity_code
            - entity_office
            - control_digits
          description: International Bank Account Number
      discriminator:
        propertyName: type
      description: Account identifier
      title: InvestmentFundSchemaAccount
    CustomerSegment:
      type: string
      enum:
        - not_assigned
        - personal
        - business
        - corporate
        - private
        - retail
      title: CustomerSegment
    InfoniteSchemasUtilsCurrencyAmountSchema2Currency:
      oneOf:
        - type: string
          format: currency
        - type: string
          enum:
            - '***'
      description: >-
        Three-letter ISO currency code — or `***` when the source did not
        disclose the currency.
      title: InfoniteSchemasUtilsCurrencyAmountSchema2Currency
    infonite__schemas__utils__CurrencyAmountSchema__2:
      type: object
      properties:
        currency:
          $ref: >-
            #/components/schemas/InfoniteSchemasUtilsCurrencyAmountSchema2Currency
          description: >-
            Three-letter ISO currency code — or `***` when the source did not
            disclose the currency.
        amount:
          type: string
          format: number
          default: nan
          description: Decimal number with 6 digits precision
      required:
        - currency
      title: infonite__schemas__utils__CurrencyAmountSchema__2
    InfoniteSchemasUtilsCurrencyAmountSchema1Currency:
      oneOf:
        - type: string
          format: currency
        - type: string
          enum:
            - '***'
      description: >-
        Three-letter ISO currency code — or `***` when the source did not
        disclose the currency.
      title: InfoniteSchemasUtilsCurrencyAmountSchema1Currency
    infonite__schemas__utils__CurrencyAmountSchema__1:
      type: object
      properties:
        currency:
          $ref: >-
            #/components/schemas/InfoniteSchemasUtilsCurrencyAmountSchema1Currency
          description: >-
            Three-letter ISO currency code — or `***` when the source did not
            disclose the currency.
        amount:
          type: string
          format: number
          description: Decimal number with 2 digits precision
      required:
        - currency
        - amount
      description: A monetary amount together with its currency.
      title: infonite__schemas__utils__CurrencyAmountSchema__1
    InfonitePydanticFieldsCommonRate1Unit:
      oneOf:
        - type: string
          enum:
            - '%'
        - type: string
          format: currency
      title: InfonitePydanticFieldsCommonRate1Unit
    infonite__pydantic__fields__common___Rate__1:
      type: object
      properties:
        value:
          type: string
          format: number
          default: NaN
          description: Decimal number with 6 digits precision
        unit:
          $ref: '#/components/schemas/InfonitePydanticFieldsCommonRate1Unit'
          default: '%'
        description:
          type:
            - string
            - 'null'
      title: infonite__pydantic__fields__common___Rate__1
    InvestmentFundSchema:
      type: object
      properties:
        id:
          type: string
          format: object-id
          description: >-
            Product ID for the current execution. Note: it may change between
            executions.
        product:
          type: string
          enum:
            - investment_asset
        sub_family:
          $ref: '#/components/schemas/InvestmentFundSchemaSubFamily'
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched
        contract:
          $ref: '#/components/schemas/GenericIdentifierSchema'
          description: Contract if present
        account:
          $ref: '#/components/schemas/InvestmentFundSchemaAccount'
          description: Account identifier
        customer_segment:
          $ref: '#/components/schemas/CustomerSegment'
        product_name:
          type: string
          description: Product name
        product_alias:
          type: string
          description: Product alias
        product_description:
          type: string
          description: Product Description
        isin:
          type: string
          description: ISIN code
        ticker:
          type: string
          description: Ticker
        market:
          type: string
          description: Market
        category:
          type: string
          description: Category
        unit_price:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__2
          description: Unit price
        quantity:
          type: string
          format: number
          default: nan
          description: The number of units of a financial instrument held by the account.
        valuation:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: The monetary value of a financial instrument held by the account.
        valuation_date:
          type: string
          format: date
          description: Valuation date
        appreciation:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: >-
            The monetary value of the appreciation of a financial instrument
            held by the account.
        performance:
          $ref: '#/components/schemas/infonite__pydantic__fields__common___Rate__1'
          description: Performance
      required:
        - id
        - product
        - sub_family
        - fetch_date
        - account
        - customer_segment
        - product_name
      title: InvestmentFundSchema
```

## Private pension plans

The retirement saving held **at this institution**, with contributions and valuation. Public pension entitlements are a different thing entirely and come from the administration — see [Public Pensions](/guides/data-models/public-pensions).

### Schema (`PensionPlanSchema`)

```yaml
components:
  schemas:
    PensionPlanType:
      type: string
      enum:
        - pension_plan:pension
      title: PensionPlanType
    PensionPlanSchemaIdentifier:
      oneOf:
        - type: object
          properties:
            type:
              type: string
              enum:
                - generic
              description: 'Discriminator value: generic'
            value:
              type: string
              description: Identifier
            entity_country:
              type: string
              format: country
              description: Entity country
            entity_code:
              type: string
              description: Entity code
            entity_office:
              type: string
              description: Entity office
            control_digits:
              type: string
              description: Control digits
          required:
            - type
            - value
          description: Generic account identifier
      discriminator:
        propertyName: type
      description: Plan number
      title: PensionPlanSchemaIdentifier
    PensionPlanSchemaLinkedAccount:
      oneOf:
        - type: object
          properties:
            type:
              type: string
              enum:
                - clabe
              description: 'Discriminator value: clabe'
            value:
              type: string
              format: clabe
              description: Clave Bancaria Estandarizada
            masked:
              type: string
              minLength: 1
              maxLength: 19
              description: Partial Clabe
            entity_country:
              type: string
              description: Bank Country
            entity_code:
              type: string
              description: Bank code
            entity_office:
              type: string
              description: Bank office
            control_digits:
              type: string
              description: Control digit
          required:
            - type
            - value
            - masked
            - entity_country
            - entity_code
            - entity_office
            - control_digits
          description: Clave Bancaria Estandarizada
        - type: object
          properties:
            type:
              type: string
              enum:
                - generic
              description: 'Discriminator value: generic'
            value:
              type: string
              description: Identifier
            entity_country:
              type: string
              format: country
              description: Entity country
            entity_code:
              type: string
              description: Entity code
            entity_office:
              type: string
              description: Entity office
            control_digits:
              type: string
              description: Control digits
          required:
            - type
            - value
          description: Generic account identifier
        - type: object
          properties:
            type:
              type: string
              enum:
                - iban
              description: 'Discriminator value: iban'
            value:
              type: string
              format: iban
              description: International Bank Account Number
            masked:
              type: string
              minLength: 1
              maxLength: 34
              description: Partial IBAN
            entity_country:
              type: string
              description: Bank Country
            entity_code:
              type: string
              description: Bank code
            entity_office:
              type: string
              description: Bank office
            control_digits:
              type: string
              description: Control digits
          required:
            - type
            - value
            - masked
            - entity_country
            - entity_code
            - entity_office
            - control_digits
          description: International Bank Account Number
      discriminator:
        propertyName: type
      description: Account identifier
      title: PensionPlanSchemaLinkedAccount
    CustomerSegment:
      type: string
      enum:
        - not_assigned
        - personal
        - business
        - corporate
        - private
        - retail
      title: CustomerSegment
    InfoniteSchemasUtilsCurrencyAmountSchema1Currency:
      oneOf:
        - type: string
          format: currency
        - type: string
          enum:
            - '***'
      description: >-
        Three-letter ISO currency code — or `***` when the source did not
        disclose the currency.
      title: InfoniteSchemasUtilsCurrencyAmountSchema1Currency
    infonite__schemas__utils__CurrencyAmountSchema__1:
      type: object
      properties:
        currency:
          $ref: >-
            #/components/schemas/InfoniteSchemasUtilsCurrencyAmountSchema1Currency
          description: >-
            Three-letter ISO currency code — or `***` when the source did not
            disclose the currency.
        amount:
          type: string
          format: number
          description: Decimal number with 2 digits precision
      required:
        - currency
        - amount
      description: A monetary amount together with its currency.
      title: infonite__schemas__utils__CurrencyAmountSchema__1
    InfoniteSchemasUtilsCurrencyAmountSchema3Currency:
      oneOf:
        - type: string
          format: currency
        - type: string
          enum:
            - '***'
      description: >-
        Three-letter ISO currency code — or `***` when the source did not
        disclose the currency.
      title: InfoniteSchemasUtilsCurrencyAmountSchema3Currency
    infonite__schemas__utils__CurrencyAmountSchema__3:
      type: object
      properties:
        currency:
          $ref: >-
            #/components/schemas/InfoniteSchemasUtilsCurrencyAmountSchema3Currency
          description: >-
            Three-letter ISO currency code — or `***` when the source did not
            disclose the currency.
        amount:
          type: string
          format: number
          default: nan
          description: Decimal number with 6 digits precision
      required:
        - currency
      title: infonite__schemas__utils__CurrencyAmountSchema__3
    InfonitePydanticFieldsCommonRate1Unit:
      oneOf:
        - type: string
          enum:
            - '%'
        - type: string
          format: currency
      title: InfonitePydanticFieldsCommonRate1Unit
    infonite__pydantic__fields__common___Rate__1:
      type: object
      properties:
        value:
          type: string
          format: number
          default: NaN
          description: Decimal number with 6 digits precision
        unit:
          $ref: '#/components/schemas/InfonitePydanticFieldsCommonRate1Unit'
          default: '%'
        description:
          type:
            - string
            - 'null'
      title: infonite__pydantic__fields__common___Rate__1
    InfoniteSchemasUtilsCurrencyAmountSchema4Currency:
      oneOf:
        - type: string
          format: currency
        - type: string
          enum:
            - '***'
      description: >-
        Three-letter ISO currency code — or `***` when the source did not
        disclose the currency.
      title: InfoniteSchemasUtilsCurrencyAmountSchema4Currency
    infonite__schemas__utils__CurrencyAmountSchema__4:
      type: object
      properties:
        currency:
          $ref: >-
            #/components/schemas/InfoniteSchemasUtilsCurrencyAmountSchema4Currency
          description: >-
            Three-letter ISO currency code — or `***` when the source did not
            disclose the currency.
        amount:
          type: string
          format: number
          default: nan
          description: Decimal number with 6 digits precision
      required:
        - currency
      title: infonite__schemas__utils__CurrencyAmountSchema__4
    PensionPlanSchema:
      type: object
      properties:
        id:
          type: string
          format: object-id
          description: >-
            Product ID for the current execution. Note: it may change between
            executions.
        product:
          type: string
          enum:
            - pension_plan
        sub_family:
          $ref: '#/components/schemas/PensionPlanType'
          description: Pension plan type
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched
        identifier:
          $ref: '#/components/schemas/PensionPlanSchemaIdentifier'
          description: Plan number
        linked_account:
          $ref: '#/components/schemas/PensionPlanSchemaLinkedAccount'
          description: Account identifier
        customer_segment:
          $ref: '#/components/schemas/CustomerSegment'
        product_name:
          type: string
          description: Product name
        product_alias:
          type: string
          description: Product alias
        product_description:
          type: string
          description: Product Description
        category:
          type: string
          description: Plan Category
        begin_date:
          type: string
          format: date
          description: Begin date
        end_date:
          type: string
          format: date
          description: End Date
        total_contribution:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Total contribution
        year_to_date_contribution:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Year to date contribution
        unit_price:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__3
          description: Unit price
        quantity:
          type: string
          format: number
          default: nan
          description: The number of units of a financial instrument held by the account.
        valuation:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: The monetary value of a financial instrument held by the account.
        valuation_date:
          type: string
          format: date
          description: Valuation date
        performance:
          $ref: '#/components/schemas/infonite__pydantic__fields__common___Rate__1'
          description: Total Performance
        performance_year_to_date:
          $ref: '#/components/schemas/infonite__pydantic__fields__common___Rate__1'
          description: Year to date performance
        performance_last_12_months:
          $ref: '#/components/schemas/infonite__pydantic__fields__common___Rate__1'
          description: Last 12 months performance
        appreciation:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__4
          description: >-
            The monetary value of the appreciation of a financial instrument
            held by the account.
      required:
        - id
        - product
        - sub_family
        - fetch_date
        - identifier
        - customer_segment
        - product_name
      title: PensionPlanSchema
```

### Schema (`PensionPlanType`)

```yaml
components:
  schemas:
    PensionPlanType:
      type: string
      enum:
        - pension_plan:pension
      title: PensionPlanType
```

**Every valuation is a snapshot, not a quote.** `valuation_date` is when the institution calculated it — usually the previous close, sometimes older for a fund. Do not present these figures as live market values, and do not compare two extractions taken at different times as if they were.