Core

Retrieves financial assets and their composition details

Retrieves financial assets and details of their composition including investment portfolios (stocks, funds, bonds, pension plans, alternative investments, crypto), credit cards, insurance, and loans. Includes ownership information for each asset as well as unique identifiers that facilitate data processing. It is possible to obtain Mock data. Check with the technical team on how to do this.

post/entities/

Request

  • Base URL: https://api.wealthreader.com
  • URL: https://api.wealthreader.com/entities/
  • Auth: none declared

Response

data obtained from the entity

successboolean required

Example response

[
  {
    "success": true,
    "payload": {
      "user_information": {
        "ID": "12345678Z",
        "name": "LUIS GARCIA BAQUERO",
        "gender": "male",
        "birth_date": "1980-09-26",
        "birth_place": "Ibiza",
        "email": "lgarcia@gmail.com",
        "cell_phone": "+34666123456",
        "address": "CALLE BAILEN 41 1A",
        "city": "MADRID",
        "country": "SPAIN",
        "postal_code": "28005",
        "marital_status": "married",
        "job": "CUENTA PROPIA"
      },
      "portfolios": [
        {
          "subtype": "funds",
          "uuid": "05e4563f5bbf2d06efd0a29ebe7edbbb4e1bff63",
          "code": "1465010091400123456789",
          "name": "Fondo Dinámico",
          "currency": "EUR",
          "total_value": 3275.6,
          "weighted_return": 8.49,
          "yield": 256.27,
          "contributions": 3019.33,
          "contracting_date": "2016-04-27",
          "linked_account": "ES4021005321592566566159",
          "portfolio_statement": "JVBERi0xLjQKJ...",
          "owners": [
            {
              "ID": "12345678Z",
              "name": "LUIS GARCIA BAQUERO",
              "role": "owner"
            }
          ],
          "composition": [
            {
              "ISIN": "LU1234567890",
              "ISIN_description": "My Fund Class A",
              "currency": "EUR",
              "weighting": 100,
              "shares": 225.0077,
              "price": 14.5577,
              "total_amount": 3275.6,
              "reference_currency": "EUR",
              "exchange_rate": 1
            }
          ],
          "transactions": [
            {
              "uuid": "05e4563f5bbf2d06efd0a29ebe7edbbb4e1bff63",
              "operation_date": "2020-01-30",
              "value_date": "2020-01-30",
              "operation_type": "purchase",
              "shares": 1076.8273,
              "price": 11.1438,
              "total_amount": 12000,
              "currency": "EUR",
              "reference_currency": "USD",
              "exchange_rate": 1
            }
          ]
        }
      ],
      "accounts": [
        {
          "uuid": "8076932f04f73e27fe608fee4d12fca8708dec8c",
          "subtype": "checking",
          "interest_rate": 0.5,
          "line_of_credit_details": {
            "credit_limit": 50000,
            "interest_rate": 4.5,
            "credit_used": 15000,
            "credit_available": 35000,
            "constitution_date": "2021-05-20",
            "expiration_date": "2031-05-20"
          },
          "code": "ES4914651234561234567890",
          "name": "Cuenta NÓMINA",
          "currency": "EUR",
          "owners": [
            {
              "ID": "12345678Z",
              "name": "LUIS GARCIA BAQUERO",
              "role": "owner"
            }
          ],
          "balances": {
            "available": 14302.07,
            "current": 14302.07
          },
          "transactions": [
            {
              "uuid": "d0c2ea4c072cf4d7b0fd494d7728260d736e6b25",
              "operation_date": "2022-12-30",
              "value_date": "2022-12-30",
              "amount": -1.1,
              "balance": 14302.07,
              "description": "Pago en TELPARK MADRID ES",
              "categorization": {
                "type": 1,
                "portfolio-uuid": "1465010091400123456789",
                "ISIN": "US88160R1014"
              },
              "transfer_details": {
                "concept": "Pago de factura 12345",
                "sender_receiver": "Juan Pérez",
                "account_number": "ESXX12341234121234567890"
              }
            }
          ]
        }
      ],
      "cards": [
        {
          "status": "active",
          "subtype": "credit",
          "uuid": "aefd89eade0a6a09d9b8eab4c22da6a6a37632e6",
          "code": "516097********1234",
          "name": "Credit Card",
          "currency": "EUR",
          "next_payment_date": "2023-01-05",
          "anual_interest": 17.48,
          "tae": 18.95,
          "balances": {
            "available": 3980,
            "limit": 4000,
            "disposed": 20
          },
          "linked_account": "ES4021005321592566566159",
          "owner": [
            {
              "ID": "12345678Z",
              "name": "LUIS GARCIA BAQUERO",
              "role": "owner"
            }
          ],
          "transactions": [
            {
              "uuid": "78ceedca9cd9d2f2bfbb2439795ab6a1fcefc12b",
              "operation_date": "2022-12-28",
              "value_date": "2022-12-28",
              "amount": -20,
              "currency": "EUR",
              "exchange_rate": 1,
              "description": "Pago en AMZN MKTP ES123CM0ZM4"
            }
          ]
        }
      ],
      "receipts": [
        {
          "last_receipt_date": "2023-07-23",
          "issuer": "Canal de Isabel II",
          "description": "RECIBO CONTRATO 328774628 FACTURA DEL 18 07 23",
          "account": "ES0123456789012345678901",
          "status": "paid",
          "amount": 50.75
        }
      ],
      "loans": [
        {
          "uuid": "0ae4d722b1c82feeafb4b36b2893230444071335",
          "contract_number": "9620.321-205439-70",
          "loan_type": "Variable rate mortgage",
          "constitution_date": "2022-02-23",
          "currency": "EUR",
          "granted_capital": 207000,
          "pending_amount": 166639.77,
          "next_installment": 1040.3,
          "linked_account": "ES0123456789012345678901",
          "holders": [
            {
              "id": "32945945D",
              "name": "Diego Serrano"
            }
          ],
          "interest_rate": 3.768,
          "expiration_date": "2042-03-01",
          "pending_receipts": 223,
          "amortization_made": [
            {
              "uuid": "8772d6c978d37d7af83094abf380b8b703e94105",
              "date": "2022-12-01",
              "amortized": 515.43,
              "interest": 524.87,
              "total": 1040.3,
              "pending_capital": 166639.77,
              "operation_type": "receipt_paid"
            }
          ],
          "amortization_pending": [
            {
              "uuid": "e59296b79e7f80cec26679d2c65883025fd59295",
              "date": "2030-12-01",
              "amortized": 515.43,
              "interest": 524.87,
              "total": 1040.3,
              "pending_capital": 66639.77,
              "operation_type": "receipt_scheduled"
            }
          ]
        }
      ],
      "deposits": [
        {
          "uuid": "0ae4d722b1c82feeafb4b36b2893230444071335",
          "code": "DPZ-1234567890",
          "name": "12-month deposit",
          "currency": "EUR",
          "principal": 10000,
          "pending_principal": 5000,
          "start_date": "2024-09-01",
          "maturity_date": "2025-09-01",
          "payment_frequency": "at_maturity",
          "capitalization": "none",
          "rate_type": "fixed",
          "nominal_interest_rate": 3,
          "apr_tae": 3.04,
          "day_count_convention": "ACT/365",
          "linked_account": "ES4021005321592566566159",
          "accrued_interest": 24.58,
          "expected_interest_total": 300,
          "withholding_tax_rate": 19,
          "status": "active",
          "early_withdrawal": {
            "allowed": true,
            "penalty_type": "interest_loss",
            "penalty_value": 100,
            "notes": "Loss of accrued interest for the current period"
          },
          "owners": [
            {
              "ID": "12345678Z",
              "name": "LUIS GARCIA BAQUERO",
              "role": "owner"
            }
          ],
          "interest_movements": [
            {
              "uuid": "90763109952d4f2ebece8dceca8254078c5384a0",
              "date": "2025-09-01",
              "period_start": "2024-09-01",
              "period_end": "2025-09-01",
              "currency": "EUR",
              "gross_interest": 300,
              "withholding_tax": 57,
              "net_interest": 243,
              "payment_type": "maturity"
            }
          ],
          "principal_movements": [
            {
              "uuid": "90763109952d4f2ebece8dceca8254078c5384a0",
              "amount": 12000
            }
          ]
        }
      ],
      "leases": [
        {
          "subtype": "leasing",
          "uuid": "1f0a0b1c2d3e4f5a6b7c8d9e0f1234567890abcd",
          "contract_number": "L-2024-000123",
          "name": "BMW 3 Series Leasing",
          "provider": {
            "name": "Banco XYZ Renting, S.A.",
            "tax_id": "A12345678"
          },
          "currency": "EUR",
          "start_date": "2024-10-01",
          "end_date": "2028-09-30",
          "term_months": 48,
          "payment_frequency": "monthly",
          "status": "active",
          "linked_account": "ES4021005321592566566159",
          "holders": [
            {
              "ID": "12345678Z",
              "name": "LUIS GARCIA BAQUERO",
              "role": "owner"
            }
          ],
          "asset": {
            "category": "vehicle",
            "description": "BMW 320d Touring",
            "vin": "WBA8G51040K123456",
            "license_plate": "1234-ABC",
            "brand": "BMW",
            "model": "320d",
            "year": 2024
          },
          "financials": {
            "capital_financed": 35000,
            "nominal_interest_rate": 4.25,
            "apr_tae": 4.38,
            "initial_fee": 3000,
            "security_deposit": 1000,
            "residual_value": 12000,
            "purchase_option": true,
            "services_included": {
              "maintenance": true,
              "insurance": true,
              "roadside_assistance": true
            },
            "vat_included": true,
            "mileage_limit_year": 15000,
            "early_termination": {
              "allowed": true,
              "penalty_type": "percentage_of_remaining",
              "penalty_value": 40
            }
          },
          "totals": {
            "paid_installments": 10,
            "remaining_installments": 38
          },
          "installments": {
            "paid": [
              {
                "uuid": "b07a1a0d3e6f4c2a9e1d0f8b7c6a5e4d3c2b1a0f",
                "date": "2025-01-01",
                "status": "pending",
                "currency": "EUR",
                "total": 625.5,
                "breakdown": {
                  "principal": 450,
                  "interest": 80,
                  "services": 70,
                  "taxes": 25.5
                }
              }
            ],
            "scheduled": [
              {
                "uuid": "b07a1a0d3e6f4c2a9e1d0f8b7c6a5e4d3c2b1a0f",
                "date": "2025-01-01",
                "status": "pending",
                "currency": "EUR",
                "total": 625.5,
                "breakdown": {
                  "principal": 450,
                  "interest": 80,
                  "services": 70,
                  "taxes": 25.5
                }
              }
            ]
          }
        }
      ],
      "insurances": [
        {
          "uuid": "0ae4d722b1c82feeafb4b36b2893230444071335",
          "code": "969032717626333",
          "coverage_category": "property",
          "name": "MyBox Hogar",
          "currency": "EUR",
          "insured_value": {
            "name": "PISO / Residencia secundaria 46023 VALENCIA",
            "value": 250000
          },
          "insured_concepts": [
            {
              "description": "Fire",
              "value": 25000
            }
          ],
          "constitution_date": "2020-01-01",
          "expiration_date": "2021-01-01",
          "next_payment_date": "2020-02-01",
          "next_installment": 800,
          "frequency": "monthly",
          "status": "active",
          "linked_account": "ES4914651234561234567890",
          "owner": {
            "ID": "07133834N",
            "name": "LUIS GARCIA BAQUERO"
          },
          "claims": [
            {
              "uuid": "8772d6c978d37d7af83094abf380b8b703e94105",
              "claim_code": "0122074354T2",
              "incident_date": "2023-05-13",
              "claimed_date": "2023-05-15",
              "description": "Rotura de lunas por impacto de objetos",
              "status": "in_process"
            }
          ]
        }
      ],
      "files": [
        {
          "file_date": "2023-07-21",
          "retrieval_type": "repository",
          "file_type": "Norma 43",
          "description": "Monthly account statement"
        }
      ],
      "contracts": [
        {
          "signing_date": "2003-09-26",
          "type": "loan",
          "subtype": "mortgage",
          "description": "Variable rate mortgage"
        }
      ],
      "factoring": [
        {
          "uuid": "a62ae601a424403d0fbe968d335378421006c277",
          "contract_number": "000117001234567",
          "name": "FACTORING PPAL SIN RECURSO",
          "assignor_id": "B12345678",
          "assignor": "QUICKSILVER DISTRIBUCION Y LOGISTICA SL",
          "assignor_type": "non-recourse-factor",
          "assignee": "Banco Sabadell",
          "currency": "EUR",
          "balances": {
            "available": 11360.26,
            "limit": 11360.26
          },
          "interest_rate": 5.25,
          "linked_account": "ES0700812345678987654321",
          "number_invoices": 8,
          "total_value": 14495.28,
          "total_advanced_value": 6919.29,
          "clients": [
            {
              "uuid": "2ea19f8f8bcda4fa5e54e139852e0a7459d16b49",
              "client_id": "A12345678",
              "client_name": "EMPRESA 1 SA",
              "limit": 50000,
              "disposed": 15000,
              "available": 35000,
              "payment_method": "transfer_payment",
              "payment_deadline": 30
            }
          ],
          "invoices": [
            {
              "uuid": "6b556584df0721e5f0b27448247c9682a6470d11",
              "invoice_id": "2023-53",
              "client_id": "A12345678",
              "operation_date": "2023-10-25",
              "due_date": "2024-01-24",
              "payment_date": "2024-01-20",
              "invoice_amount": 918.45,
              "received_amount": 873.53,
              "status": "funded"
            }
          ],
          "transactions": [
            {
              "uuid": "8a3b5c7d9e1f2a4b6c8d0e2f4a6b8c0d2e4f6a8b",
              "operation_date": "2023-10-25",
              "value_date": "2023-10-26",
              "amount": 1500,
              "currency": "EUR",
              "description": "ANTICIPO FACTURA 2023-53"
            }
          ]
        }
      ],
      "confirming": [
        {
          "uuid": "a62ae601a424403d0fbe968d335378421006c277",
          "contract_number": "000117001234567",
          "name": "CONFIRMING PPAL SIN RECURSO",
          "currency": "EUR",
          "balances": {
            "available": 11360.26,
            "limit": 11360.26
          },
          "interest_rate": 5.25,
          "linked_account": "ES0700812345678987654321",
          "number_invoices": 8,
          "total_value": 14495.28,
          "total_advanced_value": 6919.29,
          "providers": [
            {
              "uuid": "2ea19f8f8bcda4fa5e54e139852e0a7459d16b49",
              "company_id": "A12345678",
              "company_name": "EMPRESA 1 SA"
            }
          ],
          "invoices": [
            {
              "uuid": "6b556584df0721e5f0b27448247c9682a6470d11",
              "invoice_id": "2023-53",
              "provider_id": "A12345678",
              "operation_date": "2023-10-25",
              "due_date": "2024-01-24",
              "amount": 918.45,
              "status": "advanced"
            }
          ]
        }
      ],
      "employment": {
        "summary": {
          "totalDaysRegistered": 8912,
          "daysInMultipleActivity": 130,
          "daysContributedForBenefits": 8782,
          "totalTimeEquivalence": "24 años, 0 meses y 17 días."
        },
        "periods": [
          {
            "employer": "TRABAJADOR AUTONOMO",
            "regime": "AUTONOMO",
            "contract": "INDEFINIDO.TIEMPO COMPLETO.ORDINARIO",
            "category": "INGENIEROS LICENCIADOS",
            "actualStartDate": "2022-11-10",
            "startDate": "2022-11-10",
            "endDate": "Actual",
            "contributedDays": 1062
          }
        ]
      },
      "tax_returns": [
        {
          "uuid": "5f2b9c1e8a7d3046b1c9e2f4a6d8b0c3e5f7a9b1",
          "issuer": "AEAT",
          "model": "100",
          "fiscal_year": 2025,
          "period": "0A",
          "receipt_number": "2025100000123456",
          "secure_verification_code": "A1B2C3D4E5F6G7H8",
          "filing_date": "2026-05-20",
          "filing_type": "individual",
          "holder_id": "99999999R",
          "holder_name": "APELLIDO1 APELLIDO2, NOMBRE",
          "spouse_id": "11111111H",
          "spouse_name": "APELLIDO3 APELLIDO4, NOMBRE",
          "currency": "EUR",
          "general_taxable_base": 32450.18,
          "savings_taxable_base": 1250.4,
          "general_liquid_base": 30120.18,
          "savings_liquid_base": 1250.4,
          "state_gross_tax": 3655.27,
          "regional_gross_tax": 3540.12,
          "state_net_tax": 3480.15,
          "regional_net_tax": 3398.6,
          "resulting_tax": 6878.75,
          "withholdings_and_payments": 7378.45,
          "differential_tax": -499.7,
          "result_amount": -499.7,
          "result_type": "refundable"
        }
      ],
      "credit_reports": [
        {
          "uuid": "3c1f0e7a9b2d4c6e8f0a1b3c5d7e9f1a2b4c6d8e",
          "issuer": "BDE",
          "report_type": "summary",
          "report_name": "Informe Global",
          "reference": "I2026100100000000",
          "period": "2026-08",
          "request_date": "2026-10-01",
          "issue_date": "2026-10-01",
          "available_until": "2026-10-21",
          "file_name": "Informe Agregado.pdf"
        }
      ],
      "guarantees": [
        {
          "uuid": "90763109952d4f2ebece8dceca8254078c5384a0",
          "code": "f2eb8HsfBDSDseBw8HeSccOwJweJ2OfxH2xDw8Ss",
          "name": "Aval Financiero",
          "nickname": "Aval Técnico",
          "subtype": "financial",
          "currency": "EUR",
          "linked_account": "ES1001289462580857003432",
          "issuer": "Bankinter, S.A.",
          "beneficiary": "AYUNTAMIENTO DE MADRID",
          "purpose": "Licitación obra pública expediente 2025/00123",
          "issue_date": "2024-06-12",
          "expiration_date": "2026-06-11",
          "status": "active",
          "balances": {
            "guaranteed_amount": 50000,
            "available": 50000,
            "euro_equivalent": 50000
          },
          "fees_commissions": {
            "periodicity": "quarterly",
            "last_charge_date": "2025-03-31",
            "last_charge_amount": 125
          },
          "additional_info": [
            {
              "key": "euroEquivalent",
              "value": "0.00"
            }
          ]
        }
      ]
    },
    "statistics": {
      "execution_time": 0.958119869232178,
      "warnings": [
        {
          "code": 1000,
          "message": "No contracted funds",
          "product_type": "portfolios"
        }
      ],
      "operation_id": "1827C79229",
      "token": "FRJ0mHlaqZwLzu"
    }
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.