> This page is for Direct Executions.

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

# Data models

A direct execution runs one engine against one source, and what it returns depends on the kind of source: a bank, a card issuer or a consumer-finance provider returns a **financial position**; a public administration returns a **public position**. Both carry the customer profile, and one family per feature you asked for. A family you did not ask for is absent. These pages lay each model out flat, field by field, rendered from the live API specification.

## Where the data arrives

Results are **pulled, never pushed**: a direct execution's webhooks say *that* it finished, never *what* it found. Once it closes, its records wait behind your application secret, addressed by `execution_id`:

* **The whole position in one call** — [Financial Position](https://infonite.dev/direct-executions/api-reference/direct-executions-api/fetching-the-results/financial-data/direct-executions-v-1-results-financial-position) or [Public Position](https://infonite.dev/direct-executions/api-reference/direct-executions-api/fetching-the-results/public-administration/direct-executions-v-1-results-public-position). The one we recommend.
* **One family at a time** — each family has its own endpoint, for when you need one thing only or want it the moment its feature closes.

[Reading the results](/direct-executions/results) walks through both, and through deleting them when you are done.

## The financial position

From banks, card issuers and consumer-finance providers:

### Schema (`FinancialGlobalPositionSchema`)

```yaml
components:
  schemas:
    CustomerType:
      type: string
      enum:
        - person
        - company
        - unknown
      title: CustomerType
    IdentificationNumberSchemaType:
      type: string
      enum:
        - unknown
        - es:dni
        - es:nie
        - es:cif
        - es:ssn
        - co:cc
        - co:ce
        - co:nit
        - co:ti
      description: >-
        Kind of document the number belongs to (e.g. a national ID, passport,
        tax ID, or Social

        Security number).
      title: IdentificationNumberSchemaType
    IdentificationNumberSchema:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/IdentificationNumberSchemaType'
          description: >-
            Kind of document the number belongs to (e.g. a national ID,
            passport, tax ID, or Social

            Security number).
        value:
          type: string
          description: The number itself, as reported by the source.
        validated:
          type: boolean
          description: >-
            True when the value passed the platform's format and check-digit
            validation. It vouches for

            the NUMBER being well-formed — not for the official status of the
            document behind it.
        country:
          type:
            - string
            - 'null'
          format: country
          description: Country that issued the number, as a two-letter ISO code.
        valid_until:
          type: string
          format: date
          description: Expiry date of the document, when the source reports it.
      required:
        - type
        - value
        - validated
      description: >-
        One identification document: its type, its value, and whether the value
        passed validation.
      title: IdentificationNumberSchema
    PersonGender:
      type: string
      enum:
        - male
        - female
        - rather_not_say
        - unknown
      title: PersonGender
    CivilStatus:
      type: string
      enum:
        - single
        - married
        - divorced
        - widowed
        - separated
        - unknown
      title: CivilStatus
    AddressSchema:
      type: object
      properties:
        title:
          type:
            - string
            - 'null'
          description: Free label for the address (e.g. `Headquarter`, `Domicilio`).
        street:
          type:
            - string
            - 'null'
          description: 'Street line: name and number.'
        street_extra:
          type:
            - string
            - 'null'
          description: 'Second street line: floor, suite, staircase, apartment...'
        municipality:
          type:
            - string
            - 'null'
          description: Municipality the address belongs to.
        city:
          type:
            - string
            - 'null'
          description: City or town.
        state:
          type:
            - string
            - 'null'
          description: State or province code.
        country:
          type:
            - string
            - 'null'
          format: country
          description: Country, as a two-letter ISO code.
        zip_code:
          type:
            - string
            - 'null'
          description: Postal code.
      description: >-
        A postal address. It is reused wherever the platform reports one — a
        person's home, a

        company's registered office, a property's location — so these fields
        describe the address

        itself; what it belongs to is told by the object carrying it.
      title: AddressSchema
    CustomerProfileSchema:
      type: object
      properties:
        product:
          type: string
          enum:
            - customer_information
          description: >-
            The product type identifier. Always `customer_information` for this
            product.
        sub_family:
          type: string
          enum:
            - customer_information:user_profile
          description: >-
            The sub-family identifier: `customer_information:user_profile`, the
            customer's profile at

            the institution.
        fetch_date:
          type: string
          format: datetime
          description: Date this information was fetched.
        type:
          $ref: '#/components/schemas/CustomerType'
          description: >-
            The kind of customer: a person or a company. This is the switch that
            tells you how to read

            the rest of the profile.
        name:
          type: string
          description: >-
            For persons, the given name(s); for companies, the registered legal
            name (razón social).
        name_extra:
          type: string
          description: >-
            **Persons only** — the rest of the legal name; Spanish institutions
            report both surnames

            here. Empty for companies.
        alias:
          type: string
          description: >-
            How the institution addresses the customer when it differs from the
            legal name — a chosen

            or commercial name.
        identification_numbers:
          type: array
          items:
            $ref: '#/components/schemas/IdentificationNumberSchema'
          description: >-
            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.
        birth_date:
          type: string
          format: date
          description: >-
            For persons, the date of birth; for companies, the date of
            incorporation, when the source

            provides it.
        birth_country:
          type: string
          format: country
          description: Country of birth, as a two-letter ISO code.
        nationality_country:
          type: string
          format: country
          description: >-
            For persons, the country of nationality; for companies, the country
            of the registered

            seat. Two-letter ISO code.
        residence_country:
          type: string
          format: country
          description: >-
            For persons, the country of residence; for companies, the country of
            its tax residence.

            Two-letter ISO code.
        gender:
          $ref: '#/components/schemas/PersonGender'
          description: >-
            **Persons only** — gender as declared at the institution. `unknown`
            for companies, and for

            persons whose source does not disclose it.
        civil_status:
          $ref: '#/components/schemas/CivilStatus'
          description: >-
            **Persons only** — civil status as declared at the institution.
            `unknown` for companies,

            and for persons whose source does not disclose it.
        number_of_children:
          type: integer
          description: >-
            **Persons only** — number of children, when the institution records
            it. Empty for

            companies.
        emails:
          type: array
          items:
            type: string
          description: Email addresses of the customer, as they appear at the source.
        phones:
          type: array
          items:
            type: string
          description: Phone numbers of the customer, as they appear at the source.
        addresses:
          type: array
          items:
            $ref: '#/components/schemas/AddressSchema'
          description: Postal addresses of the customer, as they appear at the source.
        language:
          type: string
          format: language
          description: The customer's preferred language, as an ISO language code.
        member_since:
          type: string
          format: date
          description: >-
            Date the customer's relationship with the institution began, when
            the source reports it.
      required:
        - product
        - sub_family
        - fetch_date
        - type
        - identification_numbers
        - gender
        - civil_status
        - emails
        - phones
        - addresses
      description: >-
        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`.
      title: CustomerProfileSchema
    CustomerFamily:
      type: object
      properties:
        profile:
          $ref: '#/components/schemas/CustomerProfileSchema'
          description: Customer profile
      title: CustomerFamily
    CurrentAccountSchemaDataEnrichment:
      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: CurrentAccountSchemaDataEnrichment
    CurrentAccountSchemaIdentifier:
      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: CurrentAccountSchemaIdentifier
    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
    FinancialTransactionType:
      type: string
      enum:
        - unknown
        - opening
        - closure
        - credit
        - debit
        - default
      title: FinancialTransactionType
    FinancialTransactionStatus:
      type: string
      enum:
        - unknown
        - pending
        - booked
        - cancelled
        - failed
        - reversed
      title: FinancialTransactionStatus
    FinancialTransactionCategory:
      type: string
      enum:
        - expenses::to categorize::unclassified
        - expenses::household::other household
        - expenses::household::rent
        - expenses::household::mortgage
        - expenses::household::utilities
        - expenses::household::communications
        - expenses::household::insurance & fees
        - expenses::household::services
        - expenses::home improvement::other home improvement
        - expenses::home improvement::renovation & repairs
        - expenses::home improvement::furniture & interior
        - expenses::home improvement::garden & outdoor
        - expenses::food & drinks::other food & drinks
        - expenses::food & drinks::groceries & supermarket
        - expenses::food & drinks::dining out
        - expenses::food & drinks::coffee & snacks
        - expenses::food & drinks::alcohol & tobacco
        - expenses::transport::other transport
        - expenses::transport::car & fuel
        - expenses::transport::public transport
        - expenses::transport::flights
        - expenses::transport::taxi & ride-share
        - expenses::shopping::other shopping
        - expenses::shopping::clothes & accessories
        - expenses::shopping::electronics & gadgets
        - expenses::shopping::hobby & sports equipment
        - expenses::shopping::books & games
        - expenses::shopping::gifts
        - expenses::leisure & entertainment::other leisure & entertainment
        - expenses::leisure & entertainment::culture events
        - expenses::leisure & entertainment::hobbies, sports & fitness
        - expenses::leisure & entertainment::hotels & vacation
        - expenses::leisure & entertainment::lottery & betting
        - expenses::health & beauty::other health & beauty
        - expenses::health & beauty::pharmacy
        - expenses::health & beauty::medical
        - expenses::health & beauty::beauty & personal care
        - expenses::health & beauty::optician & dentist
        - expenses::financial & organizations::other financial expenses
        - expenses::financial & organizations::credit obligations
        - expenses::financial & organizations::fees & charges
        - expenses::financial & organizations::public dues
        - expenses::other::other expenses
        - expenses::other::education
        - expenses::other::charity
        - expenses::other::associations
        - expenses::other::pets
        - expenses::other::kids
        - expenses::other::cash withdrawals
        - expenses::other::transfers
        - expenses::other::family pension/alimony
        - income::to categorize::unclassified
        - income::income::other income
        - income::income::salary & payroll
        - income::income::passive income
        - income::income::pension
        - income::income::subsidies & grants
        - income::income::tax refunds
        - income::income::transfers
        - income::income::cash deposit
        - income::income::received gifts
        - null::to categorize::unclassified
        - null::null::other not computable
        - null::null::card adjustment
        - null::null::card payment
        - null::null::investments
        - null::null::internal & self transfers
      description: >-
        Taxonomy of financial transactions for categorization.


        Values are `family::group::leaf` codes and are what gets stored and
        served. Each

        member's docstring is the customer-facing label of that node in the
        taxonomy.
      title: FinancialTransactionCategory
    EntitySchema:
      type: object
      properties:
        name:
          type: string
          description: Name
        code:
          type: string
          description: Code
        country_code:
          type: string
          format: country
          description: Country Code
        identifier:
          $ref: '#/components/schemas/IdentificationNumberSchema'
          description: Holder identifier
      title: EntitySchema
    AccountTransactionSchema:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/FinancialTransactionType'
          description: Transaction type
        status:
          $ref: '#/components/schemas/FinancialTransactionStatus'
          description: Transaction status
        category:
          $ref: '#/components/schemas/FinancialTransactionCategory'
          description: >-
            Transaction category. Transactions are classified based on their
            context and nature. The categorization is only applied if data
            enrichment is enabled for your current application. Otherwise, this
            field will be filled with a generic category based on  the
            transaction amount. 
             Contact support for more information.
        operation_date:
          type: string
          format: date
          description: >-
            Represents the exact moment a transaction was initiated or
            authorized, regardless of when it was recorded or had an effect on
            the balance. For instance, if a purchase was made using a credit
            card, the operation_date would be the date of that purchase, even if
            the transaction was processed or reflected in the account on
            subsequent dates.
        value_date:
          type: string
          format: date
          description: >-
            The date on which the transaction effectively impacts an account
            balance. It determines when interests or other time-based
            considerations might commence. Even though a transaction might be
            logged or authorized on a different date, the value_date signifies
            the point when it truly reflects on the account’s funds.
        amount:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Transaction amount
        balance:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Account balance after the transaction
        descriptions:
          type: array
          items:
            type: string
          description: Original transaction descriptions
        provider_id:
          type: string
          description: Unique ID for the transaction in the provider system
        reference:
          type: string
          description: Transaction reference
        payee:
          $ref: '#/components/schemas/EntitySchema'
          description: Payee information, if available
        payer:
          $ref: '#/components/schemas/EntitySchema'
          description: Payer information, if available
        merchant:
          $ref: '#/components/schemas/EntitySchema'
          description: Merchant information, if available
      required:
        - type
        - status
        - category
      title: AccountTransactionSchema
    FinancialHolderRole:
      type: string
      enum:
        - unknown
        - holder
        - authorized
        - beneficiary
        - other
      title: FinancialHolderRole
    AccountHolderSchema:
      type: object
      properties:
        role:
          $ref: '#/components/schemas/FinancialHolderRole'
          description: Holder Role
        name:
          type: string
          description: Holder name
        identifier:
          $ref: '#/components/schemas/IdentificationNumberSchema'
          description: Holder identifier
        current_customer:
          type: boolean
          description: Is current customer?
      required:
        - role
      title: AccountHolderSchema
    CurrentAccountSchema:
      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:current
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched
        data_enrichment:
          $ref: '#/components/schemas/CurrentAccountSchemaDataEnrichment'
          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/CurrentAccountSchemaIdentifier'
          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
        available:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: >-
            The total accessible funds, considering all cleared and uncleared
            transactions. This represents the amount a user can use or withdraw
            immediately.
          deprecated: true
        booked:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: >-
            The net monetary amount without considering pending transactions. It
            reflects the actual balance at any given moment.
          deprecated: true
        transactions:
          type: array
          items:
            $ref: '#/components/schemas/AccountTransactionSchema'
          description: Account transactions
        holders:
          type: array
          items:
            $ref: '#/components/schemas/AccountHolderSchema'
          description: Account holders
      required:
        - id
        - product
        - sub_family
        - fetch_date
        - data_enrichment
        - identifier
        - customer_segment
        - product_name
      title: CurrentAccountSchema
    PaymentCardBrand:
      type: string
      enum:
        - American Express
        - Mastercard
        - Visa
        - Mir
        - Maestro
        - Discover
        - Verve
        - Dankort
        - Troy
        - UnionPay
        - JCB
        - Diners Club
        - other
      description: >-
        Payment card brands supported by the
        [`PaymentCardNumber`][pydantic_extra_types.payment.PaymentCardNumber].
      title: PaymentCardBrand
    PanIdentifierSchema:
      type: object
      properties:
        type:
          type: string
          enum:
            - pan
        masked:
          type: string
          minLength: 1
          maxLength: 19
          description: Partial PAN
        brand:
          $ref: '#/components/schemas/PaymentCardBrand'
          description: Card brand
      required:
        - type
        - masked
      description: Primary Account Number
      title: PanIdentifierSchema
    FinancialCardStatus:
      type: string
      enum:
        - unknown
        - active
        - cancelled
        - blocked
      title: FinancialCardStatus
    IBANIdentifierSchema:
      type: object
      properties:
        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:
        - value
        - masked
        - entity_country
        - entity_code
        - entity_office
        - control_digits
      description: International Bank Account Number
      title: IBANIdentifierSchema
    ClabeIdentifierSchema:
      type: object
      properties:
        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:
        - value
        - masked
        - entity_country
        - entity_code
        - entity_office
        - control_digits
      description: Clave Bancaria Estandarizada
      title: ClabeIdentifierSchema
    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
    CreditCardSchemaLinkedAccount:
      oneOf:
        - $ref: '#/components/schemas/IBANIdentifierSchema'
        - $ref: '#/components/schemas/ClabeIdentifierSchema'
        - $ref: '#/components/schemas/GenericIdentifierSchema'
      description: Linked account, if proceeds
      title: CreditCardSchemaLinkedAccount
    CardTransactionSchema:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/FinancialTransactionType'
          description: Transaction type
        status:
          $ref: '#/components/schemas/FinancialTransactionStatus'
          description: Transaction status
        value_date:
          type: string
          format: date
          description: >-
            Represents the moment when funds were set aside for a specific
            transaction, ensuring their readiness for eventual processing. From
            a banking perspective, this might appear as a temporary allocation
            or pre-authorization related to the purchase.
        amount:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Transaction amount
        descriptions:
          type: array
          items:
            type: string
          description: Original transaction descriptions
        provider_id:
          type: string
          description: Unique ID for the transaction in the provider system
        merchant:
          $ref: '#/components/schemas/EntitySchema'
          description: Merchant information, if available
      required:
        - type
        - status
      title: CardTransactionSchema
    CreditCardSchema:
      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_card
        sub_family:
          type: string
          enum:
            - financial_card:credit
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched
        identifier:
          $ref: '#/components/schemas/PanIdentifierSchema'
          description: PAN
        entity_country:
          type: string
          format: country
          description: Entity country
        entity_code:
          type: string
          description: Entity code
        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
        holder_name:
          type: string
          description: Card holder name
        status:
          $ref: '#/components/schemas/FinancialCardStatus'
        expiration_date:
          type: string
          format: date
          description: Card expiration date
        linked_account:
          $ref: '#/components/schemas/CreditCardSchemaLinkedAccount'
          description: Linked account, if proceeds
        available:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: >-
            The current amount of credit that a user has access to, based on
            their credit limit minus any current outstanding balances or pending
            transactions. It indicates the remaining amount the user can still
            borrow or use.
        disposed:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: The current amount of credit that a user has used or withdrawn.
        limit:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: >-
            The maximum amount of credit that a financial institution extends to
            a client through a line of credit. This represents the maximum
            amount of credit that a user can use or withdraw.
        payment_amount:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: >-
            The smallest amount that must be paid by a specified due date to
            keep the account in good standing and avoid potential penalties or
            additional interest charges. This amount generally covers the
            accrued interest and may include a portion of the principal balance.
            Paying only this amount by the due date may result in carrying a
            balance to the next billing cycle, which could incur interest.
        next_payment_date:
          type: string
          format: date
          description: Next Payment Date
        billing_period_start:
          type: string
          format: date
          description: Period Start Date
        billing_period_end:
          type: string
          format: date
          description: Period End Date
        transactions:
          type: array
          items:
            $ref: '#/components/schemas/CardTransactionSchema'
          description: Card transactions
      required:
        - id
        - product
        - sub_family
        - fetch_date
        - identifier
        - customer_segment
        - product_name
        - status
      title: CreditCardSchema
    DebitCardSchemaLinkedAccount:
      oneOf:
        - $ref: '#/components/schemas/IBANIdentifierSchema'
        - $ref: '#/components/schemas/ClabeIdentifierSchema'
        - $ref: '#/components/schemas/GenericIdentifierSchema'
      description: Linked account, if proceeds
      title: DebitCardSchemaLinkedAccount
    DebitCardSchema:
      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_card
        sub_family:
          type: string
          enum:
            - financial_card:debit
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched
        identifier:
          $ref: '#/components/schemas/PanIdentifierSchema'
          description: PAN
        entity_country:
          type: string
          format: country
          description: Entity country
        entity_code:
          type: string
          description: Entity code
        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
        holder_name:
          type: string
          description: Card holder name
        status:
          $ref: '#/components/schemas/FinancialCardStatus'
        expiration_date:
          type: string
          format: date
          description: Card expiration date
        linked_account:
          $ref: '#/components/schemas/DebitCardSchemaLinkedAccount'
          description: Linked account, if proceeds
        transactions:
          type: array
          items:
            $ref: '#/components/schemas/CardTransactionSchema'
          description: Card transactions
      required:
        - id
        - product
        - sub_family
        - fetch_date
        - identifier
        - customer_segment
        - product_name
        - status
      title: DebitCardSchema
    PrepaidCardSchemaLinkedAccount:
      oneOf:
        - $ref: '#/components/schemas/IBANIdentifierSchema'
        - $ref: '#/components/schemas/ClabeIdentifierSchema'
        - $ref: '#/components/schemas/GenericIdentifierSchema'
      description: Linked account, if proceeds
      title: PrepaidCardSchemaLinkedAccount
    PrepaidCardSchema:
      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_card
        sub_family:
          type: string
          enum:
            - financial_card:prepaid
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched
        identifier:
          $ref: '#/components/schemas/PanIdentifierSchema'
          description: PAN
        entity_country:
          type: string
          format: country
          description: Entity country
        entity_code:
          type: string
          description: Entity code
        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
        holder_name:
          type: string
          description: Card holder name
        status:
          $ref: '#/components/schemas/FinancialCardStatus'
        expiration_date:
          type: string
          format: date
          description: Card expiration date
        linked_account:
          $ref: '#/components/schemas/PrepaidCardSchemaLinkedAccount'
          description: Linked account, if proceeds
        available:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: >-
            For cards with a prepaid function, this indicates the current
            available prepaid balance that a user can access.
        transactions:
          type: array
          items:
            $ref: '#/components/schemas/CardTransactionSchema'
          description: Card transactions
      required:
        - id
        - product
        - sub_family
        - fetch_date
        - identifier
        - customer_segment
        - product_name
        - status
      title: PrepaidCardSchema
    FinancialGlobalPositionSchemaCardsItems:
      oneOf:
        - $ref: '#/components/schemas/CreditCardSchema'
        - $ref: '#/components/schemas/DebitCardSchema'
        - $ref: '#/components/schemas/PrepaidCardSchema'
      title: FinancialGlobalPositionSchemaCardsItems
    TimeDepositSchemaAccount:
      oneOf:
        - $ref: '#/components/schemas/IBANIdentifierSchema'
        - $ref: '#/components/schemas/ClabeIdentifierSchema'
        - $ref: '#/components/schemas/GenericIdentifierSchema'
      description: Deposit Account
      title: TimeDepositSchemaAccount
    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
          default: NaN
          description: Decimal number with 2 digits precision
        unit:
          $ref: '#/components/schemas/InfonitePydanticFieldsCommonRate2Unit'
          default: '%'
        description:
          type:
            - string
            - 'null'
      title: infonite__pydantic__fields__common___Rate__2
    TimeDepositSchema:
      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_deposit
        sub_family:
          type: string
          enum:
            - financial_deposit:time
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched
        account:
          $ref: '#/components/schemas/TimeDepositSchemaAccount'
          description: Deposit Account
        contract:
          $ref: '#/components/schemas/GenericIdentifierSchema'
          description: Contract if present
        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
        available:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: The total accessible funds, available for withdrawal.
        balance:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: The amount of founds currently deposited.
        start_date:
          type: string
          format: date
          description: Deposit start date
        last_date:
          type: string
          format: date
          description: Deposit last date
        interest_rate:
          $ref: '#/components/schemas/infonite__pydantic__fields__common___Rate__2'
          description: Deposit interest rate
      required:
        - id
        - product
        - sub_family
        - fetch_date
        - account
        - customer_segment
        - product_name
        - available
        - balance
      title: TimeDepositSchema
    SavingsGoalSchemaAccount:
      oneOf:
        - $ref: '#/components/schemas/IBANIdentifierSchema'
        - $ref: '#/components/schemas/ClabeIdentifierSchema'
        - $ref: '#/components/schemas/GenericIdentifierSchema'
      description: Deposit Account
      title: SavingsGoalSchemaAccount
    SavingsGoalSchema:
      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_deposit
        sub_family:
          type: string
          enum:
            - financial_deposit:goal
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched
        account:
          $ref: '#/components/schemas/SavingsGoalSchemaAccount'
          description: Deposit Account
        contract:
          $ref: '#/components/schemas/GenericIdentifierSchema'
          description: Contract if present
        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
        available:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: The total accessible funds, available for withdrawal.
        balance:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: The amount of founds currently deposited.
        start_date:
          type: string
          format: date
          description: Deposit start date
        last_date:
          type: string
          format: date
          description: Deposit last date
        interest_rate:
          $ref: '#/components/schemas/infonite__pydantic__fields__common___Rate__2'
          description: Deposit interest rate
        goal_amount:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: The goal amount of founds to be deposited.
      required:
        - id
        - product
        - sub_family
        - fetch_date
        - account
        - customer_segment
        - product_name
        - available
        - balance
      title: SavingsGoalSchema
    FinancialGlobalPositionSchemaDepositsItems:
      oneOf:
        - $ref: '#/components/schemas/TimeDepositSchema'
        - $ref: '#/components/schemas/SavingsGoalSchema'
      title: FinancialGlobalPositionSchemaDepositsItems
    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
    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
    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
    PersonalLoanSchemaLinkedAccount:
      oneOf:
        - $ref: '#/components/schemas/IBANIdentifierSchema'
        - $ref: '#/components/schemas/ClabeIdentifierSchema'
        - $ref: '#/components/schemas/GenericIdentifierSchema'
      description: Linked account
      title: PersonalLoanSchemaLinkedAccount
    PersonalLoanSchema:
      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_loan
        sub_family:
          type: string
          enum:
            - financial_loan:personal
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched
        identifier:
          $ref: '#/components/schemas/GenericIdentifierSchema'
          description: Loan identifier
        linked_account:
          $ref: '#/components/schemas/PersonalLoanSchemaLinkedAccount'
          description: Linked account
        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
        initial_balance:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Initial balance of the loan
        outstanding_balance:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Outstanding balance of the loan
        next_payment_amount:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Next payment amount
        begin_date:
          type: string
          format: date
          description: Loan start date
        renovation_date:
          type: string
          format: date
          description: Renovation Date
        end_date:
          type: string
          format: date
          description: Loan expected end date
        next_payment_date:
          type: string
          format: date
          description: Next payment date
        interest_rate:
          $ref: '#/components/schemas/infonite__pydantic__fields__common___Rate__1'
          description: Loan interest rate
        current_period:
          type: integer
          description: Current period
        pending_periods:
          type: integer
          description: Pending periods
        total_periods:
          type: integer
          description: Total periods
      required:
        - id
        - product
        - sub_family
        - fetch_date
        - identifier
        - customer_segment
        - product_name
      title: PersonalLoanSchema
    MortgageSchemaLinkedAccount:
      oneOf:
        - $ref: '#/components/schemas/IBANIdentifierSchema'
        - $ref: '#/components/schemas/ClabeIdentifierSchema'
        - $ref: '#/components/schemas/GenericIdentifierSchema'
      description: Linked account
      title: MortgageSchemaLinkedAccount
    MortgageSchema:
      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_loan
        sub_family:
          type: string
          enum:
            - financial_loan:mortgage
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched
        identifier:
          $ref: '#/components/schemas/GenericIdentifierSchema'
          description: Loan identifier
        linked_account:
          $ref: '#/components/schemas/MortgageSchemaLinkedAccount'
          description: Linked account
        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
        initial_balance:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Initial balance of the loan
        outstanding_balance:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Outstanding balance of the loan
        next_payment_amount:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Next payment amount
        begin_date:
          type: string
          format: date
          description: Loan start date
        renovation_date:
          type: string
          format: date
          description: Renovation Date
        end_date:
          type: string
          format: date
          description: Loan expected end date
        next_payment_date:
          type: string
          format: date
          description: Next payment date
        interest_rate:
          $ref: '#/components/schemas/infonite__pydantic__fields__common___Rate__1'
          description: Loan interest rate
        current_period:
          type: integer
          description: Current period
        pending_periods:
          type: integer
          description: Pending periods
        total_periods:
          type: integer
          description: Total periods
      required:
        - id
        - product
        - sub_family
        - fetch_date
        - identifier
        - customer_segment
        - product_name
      title: MortgageSchema
    FinancialGlobalPositionSchemaLoansItems:
      oneOf:
        - $ref: '#/components/schemas/PersonalLoanSchema'
        - $ref: '#/components/schemas/MortgageSchema'
      title: FinancialGlobalPositionSchemaLoansItems
    SepaDirectDebitSchemaAccount:
      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: The customer's account the debit is charged to.
      title: SepaDirectDebitSchemaAccount
    DirectDebitStatus:
      type: string
      enum:
        - unknown
        - active
        - cancelled
        - suspended
        - expired
      title: DirectDebitStatus
    BeneficiarySchemaAccount:
      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 the beneficiary collects into, when the bank discloses it.
      title: BeneficiarySchemaAccount
    BeneficiarySchema:
      type: object
      properties:
        identifier:
          type: string
          description: Beneficiary identifier, as the bank reports it.
        name:
          type: string
          description: Beneficiary name.
        account:
          $ref: '#/components/schemas/BeneficiarySchemaAccount'
          description: Account the beneficiary collects into, when the bank discloses it.
        tax_id:
          type: string
          description: Beneficiary tax ID, when the bank discloses it.
      description: Who collects the debit.
      title: BeneficiarySchema
    PayerSchema:
      type: object
      properties:
        name:
          type: string
          description: Payer name.
        identifier:
          type: string
          description: Payer identifier, as the bank reports it.
      description: Who pays the debit.
      title: PayerSchema
    DirectDebitTransactionSchema:
      type: object
      properties:
        status:
          $ref: '#/components/schemas/FinancialTransactionStatus'
          description: Status of this charge.
        issue_date:
          type: string
          format: datetime
          description: Date the charge was issued.
        payment_date:
          type: string
          format: datetime
          description: Date the charge was paid.
        concept:
          type: string
          description: Concept of the charge, as the bank reports it.
        amount:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Amount of the charge.
      required:
        - status
      description: >-
        One charge of the direct debit: when it was issued and paid, and for how
        much.
      title: DirectDebitTransactionSchema
    ProductAttachmentType:
      type: string
      enum:
        - attachment:attachment
        - attachment:supplier_invoice
        - attachment:client_invoice
        - attachment:es-tgss-life-report
        - attachment:es-tgss-contribution-base-report
        - attachment:es-aeat-model-100
        - attachment:es-cirbe-report
        - attachment:sepa-direct-debit-bill
        - attachment:person-certified-photo
      description: Product Attachment Type
      title: ProductAttachmentType
    FileAttachmentSchema:
      type: object
      properties:
        product:
          type: string
          enum:
            - attachment
          default: attachment
          description: The product type identifier. Always `attachment`.
        sub_family:
          $ref: '#/components/schemas/ProductAttachmentType'
          description: >-
            What kind of document this is (e.g.
            `attachment:es-tgss-life-report`).
        id:
          type: string
          format: object-id
          description: >-
            Attachment identifier — what the attachments endpoint of the API
            that returned the result

            takes to download the file.
        content_name:
          type: string
          description: File name of the document.
        content_hash:
          type: string
          description: Fingerprint of the content, to verify its integrity.
        content_type:
          type: string
          format: mime-type
          description: MIME type of the content.
        metadata:
          type: object
          additionalProperties:
            description: Any type
          description: >-
            Extra facts about the document, as simple key-value pairs (e.g. its
            official verification

            code, its issue date).
      required:
        - sub_family
        - id
        - content_name
        - content_type
        - metadata
      description: >-
        A document attached to a result — an official report, a receipt, an
        invoice... The entry

        describes the file; its bytes are downloaded with `id`, through the
        attachments endpoint of the

        API that returned the result.
      title: FileAttachmentSchema
    SEPADirectDebitSchema:
      type: object
      properties:
        id:
          type: string
          format: object-id
          description: >-
            Product ID for the current execution. It may change between
            executions.
        product:
          type: string
          enum:
            - direct_debit
        sub_family:
          type: string
          enum:
            - direct_debit:sepa
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched.
        account:
          $ref: '#/components/schemas/SepaDirectDebitSchemaAccount'
          description: The customer's account the debit is charged to.
        debit_reference:
          type: string
          description: Mandate/debit reference, as the bank reports it.
        status:
          $ref: '#/components/schemas/DirectDebitStatus'
          description: Status of the direct debit authorization.
        customer_segment:
          $ref: '#/components/schemas/CustomerSegment'
          description: >-
            Whether the account belongs to a personal or a business
            relationship.
        beneficiary:
          $ref: '#/components/schemas/BeneficiarySchema'
        payer:
          $ref: '#/components/schemas/PayerSchema'
        transactions:
          type: array
          items:
            $ref: '#/components/schemas/DirectDebitTransactionSchema'
          description: Recent charges of this debit, as reported by the bank.
        attachments:
          type: array
          items:
            $ref: '#/components/schemas/FileAttachmentSchema'
          default: []
          description: >-
            Supporting documents of the debit — e.g. the receipt of the most
            recent charge. Each

            entry's `id` downloads the file through the attachments endpoint of
            the API that returned this

            debit.
      required:
        - id
        - product
        - sub_family
        - fetch_date
        - account
        - status
        - customer_segment
        - beneficiary
        - payer
        - transactions
      description: >-
        A SEPA direct debit authorization, with its recent charges and
        supporting documents.
      title: SEPADirectDebitSchema
    FinancialGlobalPositionSchema:
      type: object
      properties:
        customer:
          $ref: '#/components/schemas/CustomerFamily'
          description: Customer family
        accounts:
          type: array
          items:
            $ref: '#/components/schemas/CurrentAccountSchema'
          description: Current accounts
        cards:
          type: array
          items:
            $ref: '#/components/schemas/FinancialGlobalPositionSchemaCardsItems'
          description: Cards
        deposits:
          type: array
          items:
            $ref: '#/components/schemas/FinancialGlobalPositionSchemaDepositsItems'
          description: Deposits
        investments:
          $ref: '#/components/schemas/InvestmentsFamily'
          description: Investments family
        loans:
          type: array
          items:
            $ref: '#/components/schemas/FinancialGlobalPositionSchemaLoansItems'
          description: Loans
        direct_debits:
          type: array
          items:
            $ref: '#/components/schemas/SEPADirectDebitSchema'
          description: Direct debits
      title: FinancialGlobalPositionSchema
```

#### [Banking](/direct-executions/data-models/banking/overview)

The whole family at a glance, and the envelope every banking product shares.

#### [Accounts](/direct-executions/data-models/banking/accounts)

Current and savings accounts, their balances, their holders and their transactions.

#### [Cards](/direct-executions/data-models/banking/cards)

Debit, credit and prepaid cards, with their limits and their movements.

#### [Loans & mortgages](/direct-executions/data-models/banking/credit)

What your customer owes the institution, and what it costs them every month.

#### [Deposits & savings](/direct-executions/data-models/banking/savings)

Money set aside — for a term, or for a purpose.

#### [Investments](/direct-executions/data-models/banking/investments)

Securities accounts, stocks, funds and private pension plans.

#### [Direct debits](/direct-executions/data-models/banking/direct-debits)

The standing charges against an account — who charges, how much, how often.

## The public position

From the Spanish public administrations:

### Schema (`PublicGlobalPositionSchema`)

```yaml
components:
  schemas:
    CustomerType:
      type: string
      enum:
        - person
        - company
        - unknown
      title: CustomerType
    IdentificationNumberSchemaType:
      type: string
      enum:
        - unknown
        - es:dni
        - es:nie
        - es:cif
        - es:ssn
        - co:cc
        - co:ce
        - co:nit
        - co:ti
      description: >-
        Kind of document the number belongs to (e.g. a national ID, passport,
        tax ID, or Social

        Security number).
      title: IdentificationNumberSchemaType
    IdentificationNumberSchema:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/IdentificationNumberSchemaType'
          description: >-
            Kind of document the number belongs to (e.g. a national ID,
            passport, tax ID, or Social

            Security number).
        value:
          type: string
          description: The number itself, as reported by the source.
        validated:
          type: boolean
          description: >-
            True when the value passed the platform's format and check-digit
            validation. It vouches for

            the NUMBER being well-formed — not for the official status of the
            document behind it.
        country:
          type:
            - string
            - 'null'
          format: country
          description: Country that issued the number, as a two-letter ISO code.
        valid_until:
          type: string
          format: date
          description: Expiry date of the document, when the source reports it.
      required:
        - type
        - value
        - validated
      description: >-
        One identification document: its type, its value, and whether the value
        passed validation.
      title: IdentificationNumberSchema
    PersonGender:
      type: string
      enum:
        - male
        - female
        - rather_not_say
        - unknown
      title: PersonGender
    CivilStatus:
      type: string
      enum:
        - single
        - married
        - divorced
        - widowed
        - separated
        - unknown
      title: CivilStatus
    AddressSchema:
      type: object
      properties:
        title:
          type:
            - string
            - 'null'
          description: Free label for the address (e.g. `Headquarter`, `Domicilio`).
        street:
          type:
            - string
            - 'null'
          description: 'Street line: name and number.'
        street_extra:
          type:
            - string
            - 'null'
          description: 'Second street line: floor, suite, staircase, apartment...'
        municipality:
          type:
            - string
            - 'null'
          description: Municipality the address belongs to.
        city:
          type:
            - string
            - 'null'
          description: City or town.
        state:
          type:
            - string
            - 'null'
          description: State or province code.
        country:
          type:
            - string
            - 'null'
          format: country
          description: Country, as a two-letter ISO code.
        zip_code:
          type:
            - string
            - 'null'
          description: Postal code.
      description: >-
        A postal address. It is reused wherever the platform reports one — a
        person's home, a

        company's registered office, a property's location — so these fields
        describe the address

        itself; what it belongs to is told by the object carrying it.
      title: AddressSchema
    CustomerProfileSchema:
      type: object
      properties:
        product:
          type: string
          enum:
            - customer_information
          description: >-
            The product type identifier. Always `customer_information` for this
            product.
        sub_family:
          type: string
          enum:
            - customer_information:user_profile
          description: >-
            The sub-family identifier: `customer_information:user_profile`, the
            customer's profile at

            the institution.
        fetch_date:
          type: string
          format: datetime
          description: Date this information was fetched.
        type:
          $ref: '#/components/schemas/CustomerType'
          description: >-
            The kind of customer: a person or a company. This is the switch that
            tells you how to read

            the rest of the profile.
        name:
          type: string
          description: >-
            For persons, the given name(s); for companies, the registered legal
            name (razón social).
        name_extra:
          type: string
          description: >-
            **Persons only** — the rest of the legal name; Spanish institutions
            report both surnames

            here. Empty for companies.
        alias:
          type: string
          description: >-
            How the institution addresses the customer when it differs from the
            legal name — a chosen

            or commercial name.
        identification_numbers:
          type: array
          items:
            $ref: '#/components/schemas/IdentificationNumberSchema'
          description: >-
            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.
        birth_date:
          type: string
          format: date
          description: >-
            For persons, the date of birth; for companies, the date of
            incorporation, when the source

            provides it.
        birth_country:
          type: string
          format: country
          description: Country of birth, as a two-letter ISO code.
        nationality_country:
          type: string
          format: country
          description: >-
            For persons, the country of nationality; for companies, the country
            of the registered

            seat. Two-letter ISO code.
        residence_country:
          type: string
          format: country
          description: >-
            For persons, the country of residence; for companies, the country of
            its tax residence.

            Two-letter ISO code.
        gender:
          $ref: '#/components/schemas/PersonGender'
          description: >-
            **Persons only** — gender as declared at the institution. `unknown`
            for companies, and for

            persons whose source does not disclose it.
        civil_status:
          $ref: '#/components/schemas/CivilStatus'
          description: >-
            **Persons only** — civil status as declared at the institution.
            `unknown` for companies,

            and for persons whose source does not disclose it.
        number_of_children:
          type: integer
          description: >-
            **Persons only** — number of children, when the institution records
            it. Empty for

            companies.
        emails:
          type: array
          items:
            type: string
          description: Email addresses of the customer, as they appear at the source.
        phones:
          type: array
          items:
            type: string
          description: Phone numbers of the customer, as they appear at the source.
        addresses:
          type: array
          items:
            $ref: '#/components/schemas/AddressSchema'
          description: Postal addresses of the customer, as they appear at the source.
        language:
          type: string
          format: language
          description: The customer's preferred language, as an ISO language code.
        member_since:
          type: string
          format: date
          description: >-
            Date the customer's relationship with the institution began, when
            the source reports it.
      required:
        - product
        - sub_family
        - fetch_date
        - type
        - identification_numbers
        - gender
        - civil_status
        - emails
        - phones
        - addresses
      description: >-
        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`.
      title: CustomerProfileSchema
    CustomerFamily:
      type: object
      properties:
        profile:
          $ref: '#/components/schemas/CustomerProfileSchema'
          description: Customer profile
      title: CustomerFamily
    HigherEducationSchemaSubFamily:
      type: string
      enum:
        - academic_data:higher_bachelor
        - academic_data:higher_master
        - academic_data:higher_doctorate
      title: HigherEducationSchemaSubFamily
    HigherEducationSchema:
      type: object
      properties:
        product:
          type: string
          enum:
            - academic_data
        sub_family:
          $ref: '#/components/schemas/HigherEducationSchemaSubFamily'
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched
        qualification_name:
          type: string
          description: Qualification name.
        institution_name:
          type: string
          description: Institution name.
        institution_country:
          type: string
          format: country
          description: Country of the institution.
        completion_status:
          type: string
          description: Completion status
        issue_date:
          type: string
          format: date
          description: Date when the qualification was issued.
        start_date:
          type: string
          format: date
          description: Date when the education started.
        end_date:
          type: string
          format: date
          description: Date when the education ended.
        official_id:
          type: string
          description: National registry number / Diploma serial number.
        verification_url:
          type: string
          description: Link to public administration validator.
        thesis_title:
          type: string
          description: Thesis title - Mandatory for PhD, common for Master
        field_of_study:
          type: string
          description: ISCED-F code or name (e.g., "061 ICTs")
        total_credits:
          type: string
          format: number
          description: ECTS credits (Common in Europe)
        grade_average:
          type: string
          format: number
          description: GPA or local scale (e.g., 0-10 in Spain)
      required:
        - product
        - sub_family
        - fetch_date
        - qualification_name
        - institution_name
        - institution_country
        - completion_status
        - total_credits
        - grade_average
      title: HigherEducationSchema
    SecondaryEducationSchemaSubFamily:
      type: string
      enum:
        - academic_data:secondary_general
        - academic_data:secondary_vocational
        - academic_data:professional_certification
      title: SecondaryEducationSchemaSubFamily
    SecondaryEducationSchema:
      type: object
      properties:
        product:
          type: string
          enum:
            - academic_data
        sub_family:
          $ref: '#/components/schemas/SecondaryEducationSchemaSubFamily'
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched
        qualification_name:
          type: string
          description: Qualification name.
        institution_name:
          type: string
          description: Institution name.
        institution_country:
          type: string
          format: country
          description: Country of the institution.
        institution_code:
          type: string
          description: Local school ID or center code.
        region:
          type: string
          description: State, Province, or Autonomous Community.
        completion_status:
          type: string
          description: Completion status
        issue_date:
          type: string
          format: date
          description: Date when the qualification was issued.
        start_date:
          type: string
          format: date
          description: Date when the education started.
        end_date:
          type: string
          format: date
          description: Date when the education ended.
        official_id:
          type: string
          description: National registry number / Diploma serial number.
        verification_url:
          type: string
          description: Link to public administration validator.
        study_framework:
          type: string
          description: Education system/law (e.g., "LOE", "K-12", "GCSE")
        national_registry_id:
          type: string
          description: National level ID (e.g., MEC in Spain)
        regional_registry_id:
          type: string
          description: State/Regional level ID
        archive_volume:
          type: string
          description: Book/Volume number (Libro)
        archive_entry:
          type: string
          description: Entry or order number (Folio/Orden)
      required:
        - product
        - sub_family
        - fetch_date
        - qualification_name
        - institution_name
        - institution_country
        - completion_status
      title: SecondaryEducationSchema
    AcademicFamily:
      type: object
      properties:
        higher_education_degrees:
          type: array
          items:
            $ref: '#/components/schemas/HigherEducationSchema'
          description: 'Higher education degrees:'
        secondary_education:
          type: array
          items:
            $ref: '#/components/schemas/SecondaryEducationSchema'
          description: Secondary education
      title: AcademicFamily
    DrivingLicenseSchema:
      type: object
      properties:
        category:
          type: string
          description: Class of driving license.
        date:
          type: string
          format: date
          description: Granted date.
        expires:
          type: string
          format: date
          description: Expiry date.
      required:
        - category
        - date
      title: DrivingLicenseSchema
    PointMovementSchema:
      type: object
      properties:
        description:
          type: string
          description: Description of the movement.
        date:
          type: string
          format: date
          description: Date of firmness (legal date).
        effective_date:
          type: string
          format: date
          description: Effective date of the movement.
        points_delta:
          type: integer
          description: Points added or subtracted (signed integer).
        balance_after:
          type: integer
          description: Balance after the movement.
        infraction_reference:
          type: string
          description: Reference number of the infraction.
        infraction_date:
          type: string
          format: date
          description: Date of the infraction.
        authority_name:
          type: string
          description: Name of the authority.
        authority_code:
          type: string
          description: Code of the authority.
      required:
        - description
        - date
        - points_delta
        - balance_after
      title: PointMovementSchema
    ProductAttachmentType:
      type: string
      enum:
        - attachment:attachment
        - attachment:supplier_invoice
        - attachment:client_invoice
        - attachment:es-tgss-life-report
        - attachment:es-tgss-contribution-base-report
        - attachment:es-aeat-model-100
        - attachment:es-cirbe-report
        - attachment:sepa-direct-debit-bill
        - attachment:person-certified-photo
      description: Product Attachment Type
      title: ProductAttachmentType
    FileAttachmentSchema:
      type: object
      properties:
        product:
          type: string
          enum:
            - attachment
          default: attachment
          description: The product type identifier. Always `attachment`.
        sub_family:
          $ref: '#/components/schemas/ProductAttachmentType'
          description: >-
            What kind of document this is (e.g.
            `attachment:es-tgss-life-report`).
        id:
          type: string
          format: object-id
          description: >-
            Attachment identifier — what the attachments endpoint of the API
            that returned the result

            takes to download the file.
        content_name:
          type: string
          description: File name of the document.
        content_hash:
          type: string
          description: Fingerprint of the content, to verify its integrity.
        content_type:
          type: string
          format: mime-type
          description: MIME type of the content.
        metadata:
          type: object
          additionalProperties:
            description: Any type
          description: >-
            Extra facts about the document, as simple key-value pairs (e.g. its
            official verification

            code, its issue date).
      required:
        - sub_family
        - id
        - content_name
        - content_type
        - metadata
      description: >-
        A document attached to a result — an official report, a receipt, an
        invoice... The entry

        describes the file; its bytes are downloaded with `id`, through the
        attachments endpoint of the

        API that returned the result.
      title: FileAttachmentSchema
    EUDriverDataSchema:
      type: object
      properties:
        product:
          type: string
          enum:
            - driver_data
        sub_family:
          type: string
          enum:
            - driver_data:eu_driver_data
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched
        country:
          type: string
          format: country
          description: Country that expired the license.
        licences:
          type: array
          items:
            $ref: '#/components/schemas/DrivingLicenseSchema'
          description: List of driving licenses.
        point_balance:
          type: integer
          minimum: 0
          maximum: 20
          description: Balance of the driver in points.
        name:
          type: string
          description: First name of the driver
        name_extra:
          type: string
          description: Last name of the driver.
        identifier:
          $ref: '#/components/schemas/IdentificationNumberSchema'
          description: NIF of the driver.
        dangerous_goods_authorized:
          type: boolean
          description: Whether the driver is authorized to transport dangerous goods.
        school_transport_authorized:
          type: boolean
          description: Whether the driver is authorized to transport school goods.
        address:
          type: string
          description: Address of the driver.
        point_movements:
          type: array
          items:
            $ref: '#/components/schemas/PointMovementSchema'
          description: List of movements. If not present means the data was not consulted.
        attachments:
          type: array
          items:
            $ref: '#/components/schemas/FileAttachmentSchema'
          default: []
          description: >-
            Supporting documents of this driver record. With the DGT's own
            connection, the person's

            photograph as the DGT holds it
            (`attachment:person-certified-photo`), when they are registered

            there — that is, when they hold a driving licence.
      required:
        - product
        - sub_family
        - fetch_date
        - country
        - licences
      title: EUDriverDataSchema
    VehicleInsuranceSchema:
      type: object
      properties:
        is_active:
          type: boolean
          description: Whether the vehicle has an active insurance policy.
        company:
          type: string
          description: Name of the insurance company.
        start_date:
          type: string
          format: date
          description: Start date of the insurance policy.
        end_date:
          type: string
          format: date
          description: End date of the insurance policy.
      required:
        - is_active
      description: Vehicle insurance policy.
      title: VehicleInsuranceSchema
    VehicleIncidentFlag:
      type: string
      enum:
        - seizure
        - seal
        - financing_charge
        - temporary_deregistration
        - permanent_deregistration
        - theft_deregistration
        - transfer_deregistration
        - inspection_expired
      description: >-
        The incidents that make a vehicle a risk to buy, finance or insure: what
        its registry flags

        on it, and an inspection that has expired.
      title: VehicleIncidentFlag
    SimpleVehicleReport:
      type: object
      properties:
        report_date:
          type: string
          format: datetime
          description: Date when the information was consulted.
        has_incidents:
          type: boolean
          description: >-
            Whether the vehicle has incidents, meaning that at the time of the
            inquiry, there are one or more annotations

            that prevent administrative processing or the circulation of the
            vehicle. For your safety, request a full

            vehicle report to know the details of all the information held in
            the Registry regarding the vehicle consulted.

            Always `true` when `flags` names any — an expired inspection
            included.
        flags:
          type: array
          items:
            $ref: '#/components/schemas/VehicleIncidentFlag'
          description: >-
            The incidents that make this vehicle a risk to buy, finance or
            insure: what the registry flags

            on it — a seizure, a seal, a financing charge, a deregistration —
            and `inspection_expired` when

            its inspection (ITV) had expired at the time of the report. Each
            code appears once, in no

            particular order. Absent when the source does not say; empty when it
            says there are none.

            A vehicle can have incidents no flag names, so an empty list does
            not mean `has_incidents`

            is `false`.
      required:
        - report_date
        - has_incidents
      description: >-
        Whether the vehicle has incidents, and which ones. Present only when
        `vehicles_data` is

        requested with `simple_vehicle_report: true` in its configurations.
      title: SimpleVehicleReport
    EUOwnedVehicleSchema:
      type: object
      properties:
        product:
          type: string
          enum:
            - driver_data
        sub_family:
          type: string
          enum:
            - driver_data:eu_owned_vehicle
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched
        country:
          type: string
          format: country
          description: Country where the vehicle is registered.
        registration_date:
          type: string
          format: date
          description: >-
            **Deprecated: read `last_registration_date` and
            `first_registration_date` instead.** A

            registration date as the source reports it, which is not always the
            same registration: the one

            in `country` when the source gives it, the vehicle's first
            registration when the source gives

            only that one. Still present, and filled as before.
          deprecated: true
        first_registration_date:
          type: string
          format: date
          description: >-
            Date the vehicle was registered for the first time, in any country:
            for an imported vehicle,

            its original registration abroad. It belongs to the vehicle, not to
            its owner — a vehicle

            bought second hand keeps it — and it is the date that tells the
            vehicle's age. Equal to

            `last_registration_date` when the vehicle was first registered in
            `country`. Absent when the

            source consulted does not give it — and then
            `last_registration_date` may well be the first

            registration too: the absence only says the source does not tell.
        last_registration_date:
          type: string
          format: date
          description: >-
            Date the vehicle was registered in `country`: the registration in
            force. Equal to

            `first_registration_date` for a vehicle first registered there,
            later for one registered

            abroad before. It belongs to the vehicle, not to its owner — a
            change of owner leaves it as it

            was. Absent when the source consulted does not give it — and then
            `first_registration_date` may

            well be the registration in `country` too: the absence only says the
            source does not tell.
        inspection_expiry_date:
          type: string
          format: date
          description: Expiry date of the vehicle inspection.
        inspection_pending:
          type: boolean
          description: >-
            If true, the vehicle has failed the previous inspection or is
            pending to be inspected.
        license_plate:
          type: string
          description: License plate number of the vehicle.
        administrative_situation:
          type: string
          description: Current administrative situation of the vehicle.
        vin:
          type: string
          description: Vehicle Identification Number.
        make:
          type: string
          description: Vehicle manufacturer.
        model:
          type: string
          description: Vehicle model name.
        trim:
          type: string
          description: Specific vehicle trim/variant.
        color:
          type: string
          description: Color of the vehicle.
        mileage:
          type: integer
          minimum: 0
        mileage_date:
          type: string
          format: date
          description: Date when the mileage was recorded.
        fuel_type:
          type: string
          description: Fuel type of the vehicle.
        emission_class:
          type: string
          description: Emission class of the vehicle.
        insurance:
          $ref: '#/components/schemas/VehicleInsuranceSchema'
        simple_vehicle_report:
          $ref: '#/components/schemas/SimpleVehicleReport'
      required:
        - product
        - sub_family
        - fetch_date
        - country
        - registration_date
      title: EUOwnedVehicleSchema
    DriverFamily:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/EUDriverDataSchema'
          description: Driver data
        vehicles:
          type: array
          items:
            $ref: '#/components/schemas/EUOwnedVehicleSchema'
          description: Officially owned vehicles
      title: DriverFamily
    WorkType:
      type: string
      enum:
        - unknown
        - employee
        - self_employed
        - public_employee
        - vacations
        - unemployment_benefits
        - other
      title: WorkType
    WorkContractType:
      type: string
      enum:
        - unknown
        - permanent
        - temporary
        - training
        - professional_practices
        - fixed_discontinuous
      title: WorkContractType
    WorkScheduleType:
      type: string
      enum:
        - unknown
        - full_time
        - part_time
      title: WorkScheduleType
    WorkRelationSchema:
      type: object
      properties:
        activity_start:
          type: string
          format: date
          description: >-
            Activity start date — the date the TGSS counts contributed days
            from.
        activity_end:
          type: string
          format: date
          description: Activity end date. Empty while the relation is ongoing.
        name:
          type: string
          description: >-
            Display name of the relation: the employer's name for employees, the
            regime for

            self-employment, and the situation description for benefit periods.
        regime:
          type: string
          description: Social Security regime of this relation.
        ccc:
          type: string
          description: >-
            Employer contribution account code (CCC) — the join key to
            `contribution_base_by_company`.

            Absent for self-employment, which has no employer account.
        assimilated:
          type: boolean
          default: false
          description: >-
            True for situations assimilated to registration (benefit periods,
            paid untaken

            vacations...) — periods that count for Social Security but are not
            an actual job. Skip

            them when reasoning about employment or earned income.
        work_type:
          $ref: '#/components/schemas/WorkType'
          description: >-
            Work type of this relation (e.g. `employee`, `self_employed`,
            `unemployment_benefits`).
        contract_type:
          $ref: '#/components/schemas/WorkContractType'
          description: >-
            Contract type as mapped from the TGSS classification; `unknown` when
            the source key has

            no mapping.
        work_schedule:
          $ref: '#/components/schemas/WorkScheduleType'
          description: 'Work schedule: `full_time`, `part_time`, or `unknown`.'
        contribution_group:
          type: string
          description: Contribution group of the worker in this relation.
        collective_agreement:
          type: string
          description: Collective agreement governing this relation, when declared.
        social_security_days:
          type: integer
          description: >-
            Days this relation counts for Social Security. Simultaneous
            relations each count their

            own days, so summing across relations overstates — the deduplicated
            career total is the

            top-level `social_security_days`.
        currently_active:
          type: boolean
          description: True while this relation is ongoing (it has no end date yet).
      required:
        - activity_start
        - name
        - work_type
        - contract_type
        - work_schedule
      description: >-
        One period of the person's labor life: an employment, a self-employment
        stretch, or a

        situation that counts for Social Security without being a job.
      title: WorkRelationSchema
    ContributionMonthStatus:
      type: string
      enum:
        - registered
        - no_alta
        - no_base_registered
        - pending_update
        - not_yet_elapsed
        - not_yet_settled
      description: >-
        State of one month in a social-security contribution-base history.


        The first five values are what the TGSS report prints.
        ``not_yet_settled``

        is the refined reading of a printed ``no_alta`` that falls inside a

        certified open relation near the report's emission date: contribution
        bases

        register with a settlement lag, so those months mean "not settled yet",

        never "not registered" — they must not count as gaps or zeros.
      title: ContributionMonthStatus
    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
    MonthlyBaseSchema:
      type: object
      properties:
        date:
          type: string
          format: date
          description: >-
            Last day of the contribution month — a convenience key for
            date-indexed consumers; `year`

            and `month` carry the same information.
        year:
          type: integer
          description: Contribution year.
        month:
          type: integer
          description: Contribution month (1-12).
        status:
          $ref: '#/components/schemas/ContributionMonthStatus'
          description: >-
            State of the month: `registered` (base certified by the TGSS),
            `pending_update`

            (contribution reported, amount not published yet — an existing
            contribution, NOT a gap),

            `not_yet_settled` (recent month still inside the settlement lag),
            `no_base_registered`, or

            `no_alta` (not registered that month). A month absent from the list
            altogether means no

            contribution row existed for it.
        base:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: >-
            Monthly contribution base (gross). Carries a numeric amount only
            when the month is

            `registered`; in any other state the amount is not available —
            unavailable, not zero.
        provisional:
          type: boolean
          default: false
          description: >-
            True when the base is provisional and may still be regularized by
            the TGSS — typical for

            self-employed workers until the yearly settlement.
      required:
        - date
        - year
        - month
        - status
        - base
      description: >-
        One month of contribution: its state and, when registered, the gross
        base amount.
      title: MonthlyBaseSchema
    CompanyContributionsSchema:
      type: object
      properties:
        company_name:
          type: string
          description: Employer or regime name, as certified by the TGSS.
        ccc:
          type: string
          description: >-
            Employer contribution account code (CCC) — the join key linking this
            history to the

            matching entries in `work_relations_history`. Absent for
            self-employment, which has no

            employer account.
        regime:
          type: string
          description: Social Security regime of this account.
        is_benefit_block:
          type: boolean
          default: false
          description: >-
            True when this entry tracks a benefit (e.g. cessation-of-activity
            protection for the

            self-employed), not an actual employer. Its bases are NOT earned
            income — exclude them

            from any income computation.
        months:
          type: array
          items:
            $ref: '#/components/schemas/MonthlyBaseSchema'
          default: []
          description: Monthly contribution bases of this account, most recent first.
      description: >-
        The month-by-month contribution history of one employer account (or
        regime).
      title: CompanyContributionsSchema
    IncomeFloorStatus:
      type: string
      enum:
        - computed
        - not_currently_active
        - activity_unknown
        - insufficient_data
      description: Whether a guaranteed-minimum income floor could be asserted at all.
      title: IncomeFloorStatus
    IncomeFloorBasis:
      type: string
      enum:
        - window_minimum
      description: >-
        How a company entry's floor was derived.


        The per-company list only ever contains companies CONTRIBUTING to the

        computed floor (closed/stale employments are excluded entirely, so no
        past

        salary can be misread as a current one); the enum names the derivation
        and

        leaves room for future methods.
      title: IncomeFloorBasis
    CompanyIncomeFloorSchema:
      type: object
      properties:
        company_name:
          type: string
          description: Employer or regime this floor comes from.
        ccc:
          type: string
          description: Employer contribution account code (CCC) of this company.
        work_type:
          $ref: '#/components/schemas/WorkType'
          description: Work type behind this income.
        monthly_floor:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: >-
            Estimated minimum NET monthly income from this company: its worst
            observed window

            month's net share, after worker Social Security contributions and
            IRPF withholding at

            that month's real income mix. Every unknown (contract type, age,
            family situation) is

            resolved toward more deductions, so real take-home pay can only be
            equal or higher.
        annual_floor:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Estimated minimum NET annual income from this company.
        gross_monthly_floor:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: >-
            The certified GROSS monthly floor this company's net figure derives
            from — the minimum

            contribution base over the observation window.
        gross_annual_floor:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: >-
            The certified GROSS annual floor from this company (the gross
            monthly floor x12).
        basis:
          $ref: '#/components/schemas/IncomeFloorBasis'
          description: >-
            How this floor was derived (e.g. `window_minimum`: the minimum base
            over the trailing

            window of fully certified months).
        observed_months:
          type: integer
          default: 0
          description: >-
            Number of certified months the floor is based on — the more months,
            the steadier the

            floor.
      required:
        - company_name
        - monthly_floor
        - annual_floor
        - basis
      description: >-
        One company's share of the income floor: the minimum net income it
        contributes.
      title: CompanyIncomeFloorSchema
    IncomeFloorSchema:
      type: object
      properties:
        status:
          $ref: '#/components/schemas/IncomeFloorStatus'
          description: >-
            Whether a floor could be asserted: `computed` (floor available),
            `not_currently_active`

            (no ongoing employment — e.g. between contracts, a scheduled future
            hire or an ongoing

            unemployment benefit; the current floor is zero),
            `insufficient_data` (working, but not

            enough certified months yet to measure a floor), or
            `activity_unknown` (no employment

            evidence either way).
        monthly_floor:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: >-
            Estimated minimum NET monthly income: the worst observed window
            month after worker

            Social Security contributions and IRPF withholding. A lower bound
            for risk assessment —

            NOT a salary estimate: every unknown in the conversion (contract
            type, age, family

            situation) is resolved toward more deductions, so real take-home pay
            can only be equal

            or higher. For self-employed workers it deliberately understates
            real income; combine

            with other signals.
        annual_floor:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: The net monthly floor, annualized.
        gross_monthly_floor:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: >-
            Guaranteed minimum GROSS monthly income, certified by the
            contribution bases. The net

            floor is minimized over months separately, so it can come from a
            different (net-worse)

            month than this gross minimum.
        gross_annual_floor:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: The gross monthly floor, annualized (x12).
        estimated_deduction_rate:
          type: string
          format: number
          default: nan
          description: Decimal number with 4 digits precision
        observed_months:
          type: integer
          default: 0
          description: >-
            Number of months the floor was measured over. A month only partly
            worked (a start after

            the 1st, an end before the month's last day) is left out once at
            least two full months

            exist, so its prorated pay never passes for a monthly income. Fewer
            than 3 means the

            floor rests on little evidence — typically a recent hire.
        companies:
          type: array
          items:
            $ref: '#/components/schemas/CompanyIncomeFloorSchema'
          default: []
          description: >-
            Only the companies contributing to the computed floor (ongoing,
            recent activity). Past

            employments are never listed here — their history is in
            `contribution_base_by_company` —

            so nothing in this list can be misread as a salary the person no
            longer earns.
        method_version:
          type: string
          description: >-
            Version of the floor derivation method. Bumped whenever the
            algorithm changes meaning —

            compare floors only within the same version.
      required:
        - status
      description: >-
        A guaranteed minimum NET income derived from the contribution bases — a
        floor for

        risk assessment, never a salary estimate. The certified gross lower
        bound travels

        alongside in the `gross_*` fields.
      title: IncomeFloorSchema
    TGSSSpainLaborCheckSchema:
      type: object
      properties:
        product:
          type: string
          enum:
            - social_security
          description: >-
            The product type identifier. Always `social_security` for this
            product.
        sub_family:
          type: string
          enum:
            - social_security:spain_labor_check
          description: >-
            The sub-family identifier: `social_security:spain_labor_check`, the
            Spanish Social Security (TGSS) labor life

            check.
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched.
        holder_name:
          type: string
          description: >-
            The holder's full name, as printed on the official Social Security
            reports (the PDFs).

            ⚠️ **When it is not reported, review this product carefully before
            you rely on it**: the two

            reports print different names for the same holder, or no report
            could be used.
        identifier:
          $ref: '#/components/schemas/IdentificationNumberSchema'
          description: >-
            The holder's identity document (DNI or NIE), as printed on the
            official reports; when both are

            read, they must agree on it. Not reported when no report could be
            used (not available, not

            readable, or disagreeing on the identity numbers). When the labor
            check is retrieved by

            connecting to the Social Security, both reports are read whether or
            not you ask for them as

            attachments, and without a usable one the rest of the data may come
            from its web pages instead.
        currently_active:
          type: boolean
          description: >-
            True when the person is actually WORKING right now: at least one
            entry in

            `current_work_types` is real work (`employee`, `self_employed` or
            `public_employee`).

            Receiving an unemployment benefit is not active employment. Neither
            is a hire scheduled

            for a future date: Social Security reports such a person as
            registered ("alta

            programada"), but this field stays `false` until the job actually
            starts. `false` means

            the person's current situation is known and includes no active job;
            `null` means the

            work history could not be recovered, so nothing is claimed either
            way. The value is

            deliberately cautious — it is designed for risk decisions — so only
            clearly identified

            work counts: in the rare case where an ongoing relation cannot be
            classified you get

            `false` plus a `current_work_type_unknown` warning, never an
            optimistic `true`.
        current_work_types:
          type: array
          items:
            $ref: '#/components/schemas/WorkType'
          description: >-
            The person's current work statuses: one entry per ongoing relation,
            so repeated values reveal

            simultaneous jobs (two `employee` entries = two concurrent
            employments). An ongoing benefit

            shows as `unemployment_benefits`. An empty list means nothing
            ongoing — no job and no benefit.
        social_security_days:
          type: integer
          description: >-
            Total days effectively counted by Social Security over the whole
            career. Simultaneous

            employments are counted once, so this is NOT the sum of the
            per-relation day counts.
        work_relations_history:
          type: array
          items:
            $ref: '#/components/schemas/WorkRelationSchema'
          description: >-
            Work relation history: ongoing relations first, then the finished
            ones from the most

            recently ended backwards — including situations assimilated to
            registration such as

            benefit periods.
        contribution_base_by_company:
          type: array
          items:
            $ref: '#/components/schemas/CompanyContributionsSchema'
          default: []
          description: >-
            Contribution-base history grouped per employer account, most recent
            first. Join each group to

            its work relation through the `ccc` code.
        income_floor:
          $ref: '#/components/schemas/IncomeFloorSchema'
          description: >-
            Guaranteed minimum NET income derived from the certified
            contribution bases (the certified

            gross lower bound travels alongside it). A floor for risk
            assessment, never a salary

            estimate.
        attachments:
          type: array
          items:
            $ref: '#/components/schemas/FileAttachmentSchema'
          default: []
          description: >-
            List of attached supporting documents (e.g. the original TGSS PDF
            reports this product was

            extracted from).
        contribution_base_history:
          type: array
          items:
            $ref: '#/components/schemas/MonthlyBaseSchema'
          description: >-
            Flat monthly contribution-base history, most recent first. Months
            only — company attribution lives in `contribution_base_by_company`,
            which groups these same months per employer account.
          deprecated: true
      required:
        - product
        - sub_family
        - fetch_date
        - work_relations_history
        - contribution_base_history
      description: >-
        The person's labor life with the Spanish Social Security (TGSS). It
        answers three questions:

        who they have worked for and when (`work_relations_history`), what they
        have contributed

        month by month per employer account (`contribution_base_by_company`),
        and what that means

        today — a guaranteed minimum NET income floor (`income_floor`, a lower
        bound derived from

        the contribution bases, never a salary estimate) and the person's
        current work statuses

        (`current_work_types`). Use it to verify employment, gauge income
        stability and assess risk;

        the source reports the data was read from travel in `attachments`, and
        the holder they name in

        `holder_name` and `identifier`.
      title: TGSSSpainLaborCheckSchema
    PublicPensionAmountsSchema:
      type: object
      properties:
        base:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Base pension amount
        revaluation:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Revaluation amount
        total:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: 'Total pension amount: the gross amount, before any deduction'
        net_amount:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Net amount of the pension, after all deductions
      required:
        - base
        - revaluation
        - total
        - net_amount
      title: PublicPensionAmountsSchema
    TGSSSpainPublicPensionSchema:
      type: object
      properties:
        product:
          type: string
          enum:
            - social_security
        sub_family:
          type: string
          enum:
            - social_security:spain_public_pension
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched
        product_name:
          type: string
          description: Product name
        product_alias:
          type: string
          description: Product alias
        start_date:
          type: string
          format: date
          description: Pension start date, when applicable
        regime:
          type: string
          description: Pension regime
        amounts:
          $ref: '#/components/schemas/PublicPensionAmountsSchema'
          description: Amounts of the pension, when active
      required:
        - product
        - sub_family
        - fetch_date
        - product_name
        - start_date
        - amounts
      title: TGSSSpainPublicPensionSchema
    EmploymentFamily:
      type: object
      properties:
        labor_check:
          $ref: '#/components/schemas/TGSSSpainLaborCheckSchema'
          description: Labor check
        pensions:
          type: array
          items:
            $ref: '#/components/schemas/TGSSSpainPublicPensionSchema'
          description: Public Pensions
      title: EmploymentFamily
    FiscalDataStatus:
      type: string
      enum:
        - unknown
        - data
        - draft
        - submitted
        - not_required
        - amended
      title: FiscalDataStatus
    YearlyPersonalTaxSituationSchemaFilingCategory:
      type: string
      enum:
        - individual
        - joint
      description: Category of the tax filing
      title: YearlyPersonalTaxSituationSchemaFilingCategory
    _CurrencyAmount:
      type: object
      additionalProperties:
        type: string
      title: _CurrencyAmount
    EmploymentIncomeLine:
      type: object
      properties:
        employer_id:
          type: string
          description: Identifier of the employer (NIF/CIF)
        employer_name:
          type: string
          description: Name of the employer
        gross_income:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Gross income from this employer
        tax_withheld:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Income tax withheld by this employer
        social_security_contributions:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Social security contributions paid
        taxpayer_id:
          type: string
          description: National identifier of the taxpayer for this line
      required:
        - employer_id
        - employer_name
        - gross_income
        - tax_withheld
        - social_security_contributions
        - taxpayer_id
      title: EmploymentIncomeLine
    EmploymentIncome:
      type: object
      properties:
        lines:
          type: array
          items:
            $ref: '#/components/schemas/EmploymentIncomeLine'
          description: List of employment income sources
        total_gross:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Total gross employment income
        total_withheld:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Total income tax withheld from employment
        total_social_security:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Total social security contributions
      required:
        - lines
        - total_gross
        - total_withheld
        - total_social_security
      title: EmploymentIncome
    CapitalIncomeLine:
      type: object
      properties:
        provider_id:
          type: string
          description: Identifier of the financial entity (NIF/CIF)
        provider_name:
          type: string
          description: Name of the financial entity
        account_number:
          type: string
          description: Account number or IBAN
        asset_type:
          type: string
          description: Type of asset (e.g., Interests, Dividends)
        gross_income:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Gross capital income
        tax_withheld:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Tax withheld from capital income
        penalization:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Penalization for early withdrawal
        deductible_expenses:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Deductible administration or custody fees
        taxpayer_id:
          type: string
          description: National identifier of the taxpayer for this line
      required:
        - asset_type
        - gross_income
        - tax_withheld
        - penalization
        - deductible_expenses
        - taxpayer_id
      title: CapitalIncomeLine
    CapitalIncome:
      type: object
      properties:
        lines:
          type: array
          items:
            $ref: '#/components/schemas/CapitalIncomeLine'
          description: List of capital income sources
        total_gross:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Total gross capital income
        total_withheld:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Total tax withheld from capital income
        total_penalization:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Total penalization
        total_expenses:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Total deductible expenses
      required:
        - lines
        - total_gross
        - total_withheld
        - total_penalization
        - total_expenses
      title: CapitalIncome
    CapitalGainLine:
      type: object
      properties:
        issuer_id:
          type: string
          description: Identifier of the issuer
        issuer_name:
          type: string
          description: Name of the issuer
        broker_id:
          type: string
          description: Identifier of the broker
        broker_name:
          type: string
          description: Name of the broker
        asset_description:
          type: string
          description: Description of the asset sold
        asset_type:
          type: string
          description: Type of asset (e.g., Shares, Crypto, Real Estate)
        sale_date:
          type: string
          format: date
          description: Date of sale
        sale_value:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Total sale value (net of expenses)
        sale_expenses:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Expenses associated with the sale
        taxpayer_id:
          type: string
          description: National identifier of the taxpayer for this line
      required:
        - asset_description
        - asset_type
        - sale_value
        - sale_expenses
        - taxpayer_id
      title: CapitalGainLine
    CapitalGains:
      type: object
      properties:
        lines:
          type: array
          items:
            $ref: '#/components/schemas/CapitalGainLine'
          description: List of capital gain operations
      required:
        - lines
      title: CapitalGains
    BusinessActivityLine:
      type: object
      properties:
        payer_id:
          type: string
          description: Payer NIF
        description:
          type: string
          description: Description of the business activity
        activity_code:
          type: string
          description: Activity code (IAE / NACE)
        total_income:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Total business income
        tax_withheld:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Tax withheld from the activity
        taxpayer_id:
          type: string
          description: National identifier of the taxpayer for this line
      required:
        - description
        - activity_code
        - total_income
        - tax_withheld
        - taxpayer_id
      title: BusinessActivityLine
    BusinessIncome:
      type: object
      properties:
        activities:
          type: array
          items:
            $ref: '#/components/schemas/BusinessActivityLine'
          description: List of business activities
        total_income:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Total economic activities income
        total_withheld:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Total economic activities withheld
        social_security_contributions:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Social security contributions paid
      required:
        - activities
        - total_income
        - total_withheld
        - social_security_contributions
      title: BusinessIncome
    RealEstateIncomeLine:
      type: object
      properties:
        cadastral_reference:
          type: string
          description: Cadastral reference of the property
        address:
          type: string
          description: Full address of the property
        gross_income:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Gross rental income
        deductible_expenses:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Total deductible expenses for this property
        net_income:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Net rental income
        taxpayer_id:
          type: string
          description: National identifier of the taxpayer for this line
      required:
        - address
        - gross_income
        - deductible_expenses
        - net_income
        - taxpayer_id
      title: RealEstateIncomeLine
    RealEstateIncome:
      type: object
      properties:
        properties:
          type: array
          items:
            $ref: '#/components/schemas/RealEstateIncomeLine'
          description: List of rental properties
        total_gross_income:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Total gross rental income
        total_net_income:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Total net rental income
      required:
        - properties
        - total_gross_income
        - total_net_income
      title: RealEstateIncome
    IncomeDetails:
      type: object
      properties:
        employment:
          $ref: '#/components/schemas/EmploymentIncome'
          description: Employment income details
        capital:
          $ref: '#/components/schemas/CapitalIncome'
          description: Capital income details
        capital_gains:
          $ref: '#/components/schemas/CapitalGains'
          description: Capital gains and losses details
        business:
          $ref: '#/components/schemas/BusinessIncome'
          description: Business activity income details
        real_estate:
          $ref: '#/components/schemas/RealEstateIncome'
          description: Real estate/rental income details
      required:
        - employment
        - capital
        - capital_gains
        - business
        - real_estate
      title: IncomeDetails
    DonationLine:
      type: object
      properties:
        entity_id:
          type: string
          description: Identifier of the receiving entity (NIF/CIF)
        entity_name:
          type: string
          description: Name of the receiving entity
        donation_type:
          type: string
          description: Type of donation (e.g., Donativo)
        amount:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Amount donated
        is_recurring:
          type: boolean
          description: Whether the donation is recurring
        taxpayer_id:
          type: string
          description: National identifier of the taxpayer for this line
      required:
        - entity_id
        - entity_name
        - amount
        - is_recurring
        - taxpayer_id
      title: DonationLine
    DeductionDetails:
      type: object
      properties:
        donations:
          type: array
          items:
            $ref: '#/components/schemas/DonationLine'
          description: List of donations
        total_donations:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Total donations
        personal_allowance:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Personal tax-free allowance
        family_allowance:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Family tax-free allowances (children, ascendants)
        regional_deductions:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Total deductions applied at regional level
        state_deductions:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Total deductions applied at state level
        total_deductions:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Grand total of all deductions
      required:
        - donations
        - total_donations
        - personal_allowance
        - family_allowance
        - regional_deductions
        - state_deductions
        - total_deductions
      title: DeductionDetails
    RealEstateLoanLine:
      type: object
      properties:
        loan_id:
          type: string
          description: Identifier of the loan
        lender_id:
          type: string
          description: Identifier of the lender (NIF/CIF)
        lender_name:
          type: string
          description: Name of the lender
        participation:
          type: string
          format: number
          default: nan
          description: Percentage of participation in the loan
        amortized_capital:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Total amortized capital
        interests:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Total interests paid
        financial_expenses:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Total financial expenses
        formalization_date:
          type: string
          format: date
          description: Date the loan was formalized
        taxpayer_id:
          type: string
          description: National identifier of the taxpayer for this line
      required:
        - loan_id
        - lender_id
        - lender_name
        - amortized_capital
        - interests
        - financial_expenses
        - taxpayer_id
      title: RealEstateLoanLine
    LiabilityDetails:
      type: object
      properties:
        real_estate_loans:
          type: array
          items:
            $ref: '#/components/schemas/RealEstateLoanLine'
          default: []
          description: List of real estate loans
      title: LiabilityDetails
    YearlyPersonalTaxSituationSchema:
      type: object
      properties:
        product:
          type: string
          enum:
            - tax_information
        sub_family:
          type: string
          enum:
            - tax_information:persons_yearly_fiscal_data
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched
        primary_taxpayer:
          type: string
          description: National identifier of the taxpayer
        joint_taxpayers:
          type: array
          items:
            type: string
          description: List of national identifiers for joint taxpayers
        address:
          $ref: '#/components/schemas/AddressSchema'
          description: Fiscal address for the exercise
        address_reference:
          type: string
          description: Cadastral reference for the main home
        country_code:
          type: string
          format: country
          description: Country code for the tax declaration
        currency:
          type: string
          format: currency
          description: Currency for the tax declaration
        tax_agency:
          type: string
          description: Tax agency for the tax declaration
        fiscal_year_start:
          type: string
          format: date
          description: Start date of the fiscal year
        fiscal_year_end:
          type: string
          format: date
          description: End date of the fiscal year
        status:
          $ref: '#/components/schemas/FiscalDataStatus'
          description: Status of the fiscal data
        filing_category:
          $ref: '#/components/schemas/YearlyPersonalTaxSituationSchemaFilingCategory'
          description: Category of the tax filing
        taxable_base:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Total taxable base
        total_tax_paid:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Total tax paid or withheld
        final_tax_result:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Final tax result (to be paid or refunded)
        income:
          $ref: '#/components/schemas/IncomeDetails'
          description: Detailed breakdown of income
        deductions:
          $ref: '#/components/schemas/DeductionDetails'
          description: Detailed breakdown of deductions
        liabilities:
          $ref: '#/components/schemas/LiabilityDetails'
          description: Detailed breakdown of liabilities
        attachments:
          type: array
          items:
            $ref: '#/components/schemas/FileAttachmentSchema'
          default: []
          description: List of attached supporting documents
      required:
        - product
        - sub_family
        - fetch_date
        - primary_taxpayer
        - address
        - address_reference
        - country_code
        - currency
        - tax_agency
        - fiscal_year_start
        - fiscal_year_end
        - status
        - filing_category
        - taxable_base
        - total_tax_paid
        - final_tax_result
        - income
        - deductions
        - liabilities
      title: YearlyPersonalTaxSituationSchema
    TaxesFamily:
      type: object
      properties:
        individual_yearly:
          type: array
          items:
            $ref: '#/components/schemas/YearlyPersonalTaxSituationSchema'
          description: Yearly individual tax situations
      title: TaxesFamily
    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'
          description: >-
            Total cadastral value: the value for tax purposes, usually below the
            market price.
        land_value:
          $ref: '#/components/schemas/_CurrencyAmount'
          description: Assessed land value.
        construction_value:
          $ref: '#/components/schemas/_CurrencyAmount'
          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
    PropertiesFamily:
      type: object
      properties:
        es:
          type: array
          items:
            $ref: '#/components/schemas/ESOwnedPropertySchema'
          description: Officially owned properties
      title: PropertiesFamily
    EuCreditRegistryDataSchemaSubFamily:
      type: string
      enum:
        - credit_registry_data:es_cirbe_detailed
        - credit_registry_data:es_cirbe_aggregated
      description: >-
        Which report this is: detailed or aggregated — what the document turned
        out to be, not what was

        requested. A holder with nothing declared to the register only ever gets
        the aggregated report.
      title: EuCreditRegistryDataSchemaSubFamily
    CreditRegistryProductType:
      type: string
      enum:
        - securities_lending
        - trade_credit_with_recourse
        - trade_credit_without_recourse
        - trade_receivables
        - financial_credit
        - financial_lease
        - reverse_repurchase_agreement
        - debt_securities
        - financial_guarantee
        - forward_deposit
        - non_financial_guarantee
        - irrevocable_documentary_credit
        - available_in_other_commitments
        - overdraft
        - credit_card_debt
        - deposit
        - revolving_credit
        - credit_line
        - other_loans
      description: Type of product or operation ("Tipo de producto/operación").
      title: CreditRegistryProductType
    CreditRegistryInterventionNature:
      type: string
      enum:
        - direct_holder
        - guarantor
        - bill_signatory
      description: >-
        How the report's holder takes part in the operation ("Naturaleza de la
        intervención").
      title: CreditRegistryInterventionNature
    CreditRegistryJointLiability:
      type: string
      enum:
        - joint_and_several
        - collective
        - not_joint_and_several
      description: >-
        Whether the holder answers for the operation together with others
        ("Solidario/colectivo").


        A CIR report prints nothing when neither applies; that is "not stated",
        not a member.
      title: CreditRegistryJointLiability
    CreditRegistryResidualMaturity:
      type: string
      enum:
        - up_to_three_months
        - three_months_to_one_year
        - one_to_five_years
        - over_five_years
        - indeterminate
      description: >-
        Time left between the report's date and the operation's maturity ("Plazo
        residual").
      title: CreditRegistryResidualMaturity
    CreditRegistryRealGuarantee:
      type: string
      enum:
        - none
        - financial_assets_pledge
        - real_estate_mortgage
        - other_real_guarantee
        - life_insurance_pledge
        - other_physical_collateral
        - credit_derivatives
        - financial_guarantee_other_than_credit_derivatives
        - other_protection
        - residential_real_estate
        - offices_and_commercial_premises
        - commercial_real_estate
        - debt_securities
        - gold
        - cash_and_deposits
        - loans
        - trade_receivables
        - equity_and_investment_fund_shares
      description: >-
        Type of the principal real (collateral) guarantee ("Tipo de garantía
        real principal").
      title: CreditRegistryRealGuarantee
    CreditRegistryGuaranteeCoverage:
      type: string
      enum:
        - total
        - partial
      description: >-
        How much of the risk (drawn and available) the principal guarantee
        covers.
      title: CreditRegistryGuaranteeCoverage
    CreditRegistryPersonalGuarantee:
      type: string
      enum:
        - none
        - public_administration
        - other_personal_guarantee
        - reporting_entity
        - public_credit_insurer
        - unspecified
      description: >-
        Type of the principal personal guarantee, beyond the direct holders' own
        ("Tipo de garantía personal principal").
      title: CreditRegistryPersonalGuarantee
    CreditRegistryOperationSituation:
      type: string
      enum:
        - standard
        - restructured_under_rdl_6_2012
        - refinanced_or_restructured
        - creditors_agreement
        - default_90_days_to_4_years
        - default_over_4_years
        - written_off
      description: Special situation of the operation ("Situación de la operación").
      title: CreditRegistryOperationSituation
    OperationSchema:
      type: object
      properties:
        entity_name:
          type:
            - string
            - 'null'
          description: Name of the reporting entity. Detailed reports only.
        entity_code:
          type:
            - string
            - 'null'
          description: >-
            Bank of Spain code of the reporting entity (e.g. `0182`). Detailed
            reports only.
        operation_code:
          type:
            - string
            - 'null'
          description: >-
            Unique code of the operation, as the entity reports it. Detailed
            reports only.
        product_type:
          oneOf:
            - $ref: '#/components/schemas/CreditRegistryProductType'
            - type: 'null'
          description: >-
            Type of product: a loan, a lease, a guarantee… Empty only if the
            code is new to us; see `product_type_code`.
        product_type_code:
          type:
            - string
            - 'null'
          description: Product code as printed (e.g. `V32`).
        intervention_nature:
          oneOf:
            - $ref: '#/components/schemas/CreditRegistryInterventionNature'
            - type: 'null'
          description: >-
            How the holder takes part: as the direct obligor, or as a guarantor
            of someone else's operation.
        intervention_nature_code:
          type:
            - string
            - 'null'
          description: Intervention code as printed (e.g. `T11`).
        collective_status:
          oneOf:
            - $ref: '#/components/schemas/CreditRegistryJointLiability'
            - type: 'null'
          description: >-
            Whether the holder answers jointly and severally, or collectively,
            with others. Empty when neither.
        collective_status_code:
          type:
            - string
            - 'null'
          description: Code as printed (e.g. `T33`).
        participants_number:
          type:
            - integer
            - 'null'
          minimum: 1
          description: >-
            Number of participants in a joint and several or collective
            operation.
        currency:
          type: string
          format: currency
          description: >-
            Currency the operation is contracted in. `XXX` means "other
            currencies".
        maturity_type:
          oneOf:
            - $ref: '#/components/schemas/CreditRegistryResidualMaturity'
            - type: 'null'
          description: Time left to maturity at the report's date.
        maturity_type_code:
          type:
            - string
            - 'null'
          description: Maturity code as printed (e.g. `L08`).
        real_guarantee_type:
          oneOf:
            - $ref: '#/components/schemas/CreditRegistryRealGuarantee'
            - type: 'null'
          description: 'Main real guarantee (collateral): a mortgage, a pledge… or `none`.'
        real_guarantee_type_code:
          type:
            - string
            - 'null'
          description: Code as printed (e.g. `G19`).
        real_guarantee_coverage:
          oneOf:
            - $ref: '#/components/schemas/CreditRegistryGuaranteeCoverage'
            - type: 'null'
          description: >-
            Whether the real guarantee covers all of the risk or part of it.
            Empty when there is no guarantee.
        real_guarantee_coverage_code:
          type:
            - string
            - 'null'
          description: Code as printed (e.g. `E14`).
        personal_guarantee_type:
          oneOf:
            - $ref: '#/components/schemas/CreditRegistryPersonalGuarantee'
            - type: 'null'
          description: Main personal guarantee beyond the holders' own, or `none`.
        personal_guarantee_type_code:
          type:
            - string
            - 'null'
          description: >-
            Code as printed (e.g. `G10`). Empty when there is no personal
            guarantee.
        personal_guarantee_coverage:
          oneOf:
            - $ref: '#/components/schemas/CreditRegistryGuaranteeCoverage'
            - type: 'null'
          description: Whether the personal guarantee covers all of the risk or part of it.
        personal_guarantee_coverage_code:
          type:
            - string
            - 'null'
          description: Code as printed (e.g. `E15`).
        operation_status:
          oneOf:
            - $ref: '#/components/schemas/CreditRegistryOperationSituation'
            - type: 'null'
          description: >-
            Special situation of the operation: refinanced, in default, written
            off… `standard` when none applies.
        operation_status_code:
          type:
            - string
            - 'null'
          description: >-
            Code as printed (e.g. `I19`). Empty when no special situation
            applies.
        total_drawn:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: >-
            Amount drawn, overdue amounts included. In an aggregated report,
            exact to the thousand.
        overdue:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: >-
            Part of the drawn amount that is overdue, with a first default over
            90 days old.
        arrears:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: >-
            Part of the overdue amount that is default interest and enforceable
            expenses.
        risk_available:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Amount still available to draw.
      required:
        - currency
      title: OperationSchema
    MinorRiskSchema:
      type: object
      properties:
        entity_name:
          type: string
          description: >-
            Name of an entity whose accumulated risk with the holder is below
            the reporting threshold.
        entity_code:
          type:
            - string
            - 'null'
          description: Bank of Spain code of the entity.
        limit_amount:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: >-
            The reporting threshold: 1,000 EUR from period 01-2021, 9,000 EUR
            before.
      required:
        - entity_name
      title: MinorRiskSchema
    EUCreditRegistryDataSchema:
      type: object
      properties:
        product:
          type: string
          enum:
            - credit_registry_data
          description: The product type identifier.
        sub_family:
          $ref: '#/components/schemas/EuCreditRegistryDataSchemaSubFamily'
          description: >-
            Which report this is: detailed or aggregated — what the document
            turned out to be, not what was

            requested. A holder with nothing declared to the register only ever
            gets the aggregated report.
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched.
        country:
          type: string
          format: country
          description: Country of the credit registry.
        holder_code:
          type: string
          description: >-
            The holder's code exactly as the report prints it (e.g.
            `ES44444444A`). Not reported when the

            report could not be read.
        holder_name:
          type: string
          description: >-
            Full name or business name of the holder, as the report prints it.
            Not reported when the report

            could not be read: the attached report is then the only reference.
        identifier:
          $ref: '#/components/schemas/IdentificationNumberSchema'
          description: >-
            The holder's national identifier, from the report's holder code. Not
            reported when the report

            could not be read.
        report_month:
          type: string
          description: Period the operations correspond to, `MM-YYYY`.
        consultation_date:
          type:
            - string
            - 'null'
          format: datetime
          description: When the register's data was taken, as the report states it.
        total_drawn:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: >-
            Total drawn across every operation in the system. In an aggregated
            report, exact to the thousand.
        total_overdue:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Total overdue across every operation in the system.
        total_arrears:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Total default interest and enforceable expenses in the system.
        total_risk_available:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Total still available to draw in the system.
        operations:
          type: array
          items:
            $ref: '#/components/schemas/OperationSchema'
          default: []
          description: >-
            The operations: one per operation in a detailed report, one per
            group in an aggregated one.
        minor_risks:
          type: array
          items:
            $ref: '#/components/schemas/MinorRiskSchema'
          default: []
          description: >-
            Entities whose accumulated risk is below the reporting threshold.
            Detailed reports only.
        attachments:
          type: array
          items:
            $ref: '#/components/schemas/FileAttachmentSchema'
          default: []
          description: The original report (PDF).
      required:
        - product
        - sub_family
        - fetch_date
        - country
        - report_month
      description: >-
        The holder's risk position at a central credit register: in Spain, the
        Bank of

        Spain's CIRBE report, detailed (one row per operation and entity) or
        aggregated

        (operations grouped, no entities).


        Every key the register prints comes twice: as its meaning (an enum, the
        same

        whatever the report's period) and as the printed code (the `*_code`
        fields).


        Every amount is always present. One the report did not give — when the
        report

        could not be read — comes with currency `***` and amount `NaN`: unknown,
        never zero.
      title: EUCreditRegistryDataSchema
    CreditFamily:
      type: object
      properties:
        registry:
          type: array
          items:
            $ref: '#/components/schemas/EUCreditRegistryDataSchema'
          description: Credit registry data
      title: CreditFamily
    PublicGlobalPositionSchema:
      type: object
      properties:
        customer:
          $ref: '#/components/schemas/CustomerFamily'
          description: Customer family
        academic:
          $ref: '#/components/schemas/AcademicFamily'
          description: Academic family
        driver:
          $ref: '#/components/schemas/DriverFamily'
          description: Driver & vehicles family
        employment:
          $ref: '#/components/schemas/EmploymentFamily'
          description: Employment family
        tax:
          $ref: '#/components/schemas/TaxesFamily'
          description: Tax family
        properties:
          $ref: '#/components/schemas/PropertiesFamily'
          description: Properties family
        credit:
          $ref: '#/components/schemas/CreditFamily'
          description: Credit registry family
      title: PublicGlobalPositionSchema
```

#### [Labor Check](/direct-executions/data-models/labor-check)

Your customer's working life with the Spanish Social Security (TGSS).

#### [Public Pensions](/direct-executions/data-models/public-pensions)

The public pensions they receive from the Spanish Social Security.

#### [Credit Registry](/direct-executions/data-models/credit-registry)

Their risk position at the Banco de España's credit registry (CIRBE).

#### [Taxes](/direct-executions/data-models/taxes)

Their yearly fiscal data and income-tax return, from the tax agency (AEAT).

#### [Properties](/direct-executions/data-models/properties)

Real estate registered to them in the Spanish Cadastre.

#### [Driver](/direct-executions/data-models/driver)

Their driving record, from the traffic authority (DGT).

#### [Vehicles](/direct-executions/data-models/vehicles)

The vehicles registered to them, from the traffic authority (DGT).

#### [Academic Records](/direct-executions/data-models/academic)

Their official degrees and qualifications, from the Spanish registries.

## In both

#### [Customer profile](/direct-executions/data-models/customer-profile)

Your customer's identity as the source knows it — person or company.

#### [Attachments](/direct-executions/data-models/attachments)

The official documents behind the data, listed and downloaded on their own.

**Invoices** from a utility, a telecom or a supplier portal are served under `/commercial/v1/`, received and issued separately; the [API reference](https://infonite.dev/direct-executions/api-reference/direct-executions-api/fetching-the-results/commercial-data/direct-executions-v-1-results-commercial-supplier-invoices) carries their schema beside each endpoint.