# @envizage/services > A list of Javascript methods and an HTTP client implementation that can be used to interact with the `Envizage API`. Type definitions are included. Latest version **0.5.0** (published 2025-07-04) · 0 weekly downloads ## Install ```sh npm install @envizage/services pnpm add @envizage/services yarn add @envizage/services bun add @envizage/services ``` ## Health **Score 30/100 (F)** — status: maintenance-mode. Positive: has types; no vulnerabilities. Warnings: low downloads; no esm support; pre 1.0. Negative: stale; low maintenance score. ## Facts | | | |---|---| | Version | 0.5.0 | | Published | 2025-07-04 | | First published | 2022-09-02 | | Weekly downloads | 0 | | TypeScript types | bundled | | Module format | CommonJS | | Dependencies | 0 | | Unpacked size | 640.1 KB | | Known vulnerabilities | 0 | | Install scripts | no | | Maintainers | envizage | ## Links - npm: https://www.npmjs.com/package/@envizage/services - npm.io page: https://npm.io/package/@envizage/services ## Recent versions - 0.5.0 (latest) — 2025-07-04 - 0.4.0 — 2025-01-17 - 0.3.31 — 2025-01-16 - 0.3.30 — 2025-01-15 - 0.3.29 — 2024-09-11 - 0.3.28 — 2024-09-11 - 0.3.27 — 2023-11-27 - 0.3.26 — 2023-10-18 - 0.3.25 — 2023-10-18 - 0.3.24 — 2023-10-18 - 0.3.23 — 2023-10-18 - 0.3.22 — 2023-09-06 - 0.3.21 — 2023-03-08 - 0.3.20 — 2023-02-15 - 0.3.19 — 2023-02-09 - … 23 more at https://npm.io/package/@envizage/services/versions ## README # Envizage Services A list of Javascript methods and an HTTP client implementation that can be used to interact with the `Envizage API`. Type definitions are included. # Table of contents 1. [Pre-requisites ](#prereq) 2. [Installation ](#installation) 3. [Usage ](#usage) 1. [HTTP Client](#httpClient) ## 1. Pre-requisites The `@envizage/model` package is a peer dependency for this project. Make sure that a version equal to or newer than the minimum required in the `package.json` file is installed. You can install the `@envizage/model` package using the following command:" ------- ```sh $ npm install --save @envizage/model # Or alternatively: `yarn add @envizage/model` ``` ## 2. Installation The SDK package can be installed as a usual npm package: ------- ```sh $ npm install --save @envizage/services # Or alternatively: `yarn add @envizage/services` ``` ## 3. Usage ### 1. The HTTP Client An HTTP Client implementation is required as a dependency for all services included in this SDK. The HTTP client that will be injected has to implement the `IHttpClient` interface: ```sh export interface IHttpClient { get: (url: string, params?: Map, headerMap?: string[][]) => Promise, post: (url: string, body: T, params?: Map, headerMap?: string[][]) => Promise, put: (url: string, body: T, params?: Map, headerMap?: string[][]) => Promise, remove: (url: string, params?: Map, headerMap?: string[][]) => Promise } ``` A user of the SDK can either implement that interface or import a ready fetch-based implementation that comes with the SDK: ```sh import { HttpClient } from "@envizage/services"; ``` ### 2. Envizage API service implementations | Service name | API Endpoint | Methods | | ------------- |:-------------:| :----: | ||Asset services|| | PhysicalAssetService | /scenarios/{scenarioId}/assets/physical/ |query,get,create,update,delete | | PortfolioAssetService | /scenarios/{scenarioId}/assets/portfolio/ |query,get,create,update,delete | | | PortfolioFinancialAssetService | /scenarios/{scenarioId}/assets/portfolio/{portfolioId}/financial/ |query,get,create,update,delete | | PropertyAssetService | /scenarios/{scenarioId}/assets/properties/ |query | | InvestmentPropertyAssetService | /scenarios/{scenarioId}/assets/properties/investment/ |query,get,create,update,delete | | ResidentialPropertyAssetService | /scenarios/{scenarioId}/assets/properties/residential/ |query,get,create,update,delete | | AssetForPersonService | /scenarios/{scenarioId}/persons/{personId}/assets/ |queryForPerson | | PortfolioAssetForPersonService | /scenarios/{scenarioId}/persons/{personId}/assets/portfolio/ |query,get,create,update,delete | | PortfolioFinancialAssetForPersonService | /scenarios/{scenarioId}/persons/{personId}/assets/portfolio/{portfolioId}/financial|queryForPerson,getForPerson,createForPerson,updateForPerson,deleteForPerson | | ResidentialPropertyAssetForPersonService | /scenarios/{scenarioId}/persons/{personId}/assets/properties/residential/ |queryForPerson,getForPerson,createForPerson,updateForPerson,deleteForPerson | | InvestmentPropertyAssetForPersonService | /scenarios/{scenarioId}/persons/{personId}/assets/properties/investment/ |queryForPerson,getForPerson,createForPerson,updateForPerson,deleteForPerson | ||User configuration|| | UserConfigurationService | /config/user |queryForComponent,queryForProfile,get,create,update,delete | ||Expenses|| | LivingExpenseService | /scenarios/{scenarioId}/expenses/living/ |query,get,create,update,delete | | MortgageExpenseService | /scenarios/{scenarioId}/expenses/mortgage/ |query,get,create,update,delete | | PortfolioContributionExpenseService | /scenarios/{scenarioId}/expenses/portfolio-contribution/ |query,get,create,update,delete | | RentExpenseService | /scenarios/{scenarioId}/expenses/rent/ |query,get,create,update,delete | | EmployeePensionContributionExpenseForPersonService | /scenarios/{scenarioId}/persons/{personId}/expenses/employee-pension-contribution/ |queryForPerson,getForPerson,createForPerson,updateForPerson,deleteForPerson | | InsurancePremiumExpenseForPersonService | /scenarios/{scenarioId}/persons/{personId}/expenses/insurance-premium/ |queryForPerson,getForPerson,createForPerson,updateForPerson,deleteForPerson | | LivingExpenseForPersonService | /scenarios/{scenarioId}/persons/{personId}/expenses/living/ |queryForPerson,getForPerson,createForPerson,updateForPerson,deleteForPerson | | MortgageExpenseForPersonService | /scenarios/{scenarioId}/persons/{personId}/expenses/mortgage/ |queryForPerson,getForPerson,createForPerson,updateForPerson,deleteForPerson | | PortfolioContributionExpenseForPersonService | /scenarios/{scenarioId}/persons/{personId}/expenses/portfolio-contribution/ |queryForPerson,getForPerson,createForPerson,updateForPerson,deleteForPerson | | RentExpenseForPersonService | /scenarios/{scenarioId}/persons/{personId}/expenses/rent/ |queryForPerson,getForPerson,createForPerson,updateForPerson,deleteForPerson | ||Incomes|| | EmployerPensionContributionIncomeService | /scenarios/{scenarioId}/incomes/employer-pension-contribution/ |query,get,create,update,delete | | InsuranceIncomeService | /scenarios/{scenarioId}/incomes/insurance/ |query,get,create,update,delete | | RentIncomeService | /scenarios/{scenarioId}/incomes/rent/ |query,get,create,update,delete | | UnearnedIncomeService | /scenarios/{scenarioId}/incomes/unearned/ |query,get,create,update,delete | | EarnedIncomeForPersonService | /scenarios/{scenarioId}/persons/{personId}/incomes/earned/ |queryForPerson,getForPerson,createForPerson,updateForPerson,deleteForPerson | | InsuranceIncomeForPersonService | /scenarios/{scenarioId}/persons/{personId}/incomes/insurance/ |queryForPerson,getForPerson,createForPerson,updateForPerson,deleteForPerson | | PensionAnnuityIncomeForPersonService | /scenarios/{scenarioId}/persons/{personId}/incomes/pension/annuity/ |queryForPerson,getForPerson,createForPerson,updateForPerson,deleteForPerson | | PensionDrawdownIncomeForPersonService | /scenarios/{scenarioId}/persons/{personId}/incomes/pension/drawdown/ |queryForPerson,getForPerson,createForPerson,updateForPerson,deleteForPerson | | PensionLumpSumIncomeForPersonService | /scenarios/{scenarioId}/persons/{personId}/incomes/pension/lumpsum/ |queryForPerson,getForPerson,createForPerson,updateForPerson,deleteForPerson | | StatePensionIncomeForPersonService | /scenarios/{scenarioId}/persons/{personId}/incomes/pension/state/ |queryForPerson,getForPerson,createForPerson,updateForPerson,deleteForPerson | | RentIncomeForPersonService | /scenarios/{scenarioId}/persons/{personId}/incomes/rent/ |queryForPerson,getForPerson,createForPerson,updateForPerson,deleteForPerson | | UnearnedIncomeForPersonService | /scenarios/{scenarioId}/persons/{personId}/incomes/unearned/ |queryForPerson,getForPerson,createForPerson,updateForPerson,deleteForPerson | | EmployerPensionContributionIncomeForPersonService | /scenarios/{scenarioId}/persons/{personId}/incomes/pension/state/ |queryForPerson,getForPerson,createForPerson,updateForPerson,deleteForPerson | | StatePensionIncomeForPersonService | /scenarios/{scenarioId}/persons/{personId}/incomes/employer-pension-contribution/ |queryForPerson,getForPerson,createForPerson,updateForPerson,deleteForPerson | ||Goals|| | TypedGoalService | /scenarios/{scenarioId}/goals/typed/ |query,get,create,update,delete | | TypedGoalForPersonService | /scenarios/{scenarioId}/persons/{personId}/goals/typed/ |queryForPerson,getForPerson,createForPerson,updateForPerson,deleteForPerson | ||Liabilities|| | MortgageLiabilityService | /scenarios/{scenarioId}/liabilities/mortgage/ |query,get,create,update,delete | | OtherSecuredLiabilityService | /scenarios/{scenarioId}/liabilities/secured-debts/ |query,get,create,update,delete | | UnsecuredLiabilityService | /scenarios/{scenarioId}/liabilities/unsecured-debts/ |query,get,create,update,delete | | MortgageLiabilityForPersonService | /scenarios/{scenarioId}/persons/{personId}/persons/${personId}/liabilities/mortgages/ |queryForPerson,getForPerson,createForPerson,updateForPerson,deleteForPerson | | OtherSecuredLiabilityForPersonService | /scenarios/{scenarioId}/persons/{personId}/persons/${personId}/liabilities/secured-debts/ |queryForPerson,getForPerson,createForPerson,updateForPerson,deleteForPerson | | UnsecuredLiabilityForPersonService | /scenarios/{scenarioId}/persons/{personId}/liabilities/unsecured-debts/ |queryForPerson,getForPerson,createForPerson,updateForPerson,deleteForPerson | ||Persons|| | PrimaryPersonService | /scenarios/{scenarioId}/persons/primary/ |get,update | | PartnerPersonService | /scenarios/{scenarioId}/persons/partner/ |get,create,update,delete | | ParentPersonService | /scenarios/{scenarioId}/persons/parents/ |query,get,create,update,delete | | ChildPersonService | /scenarios/{scenarioId}/persons/children/ |query,get,create,update,delete | ||Preferences|| | PrimaryPersonService | /scenarios/{scenarioId}/preference/{key} |get,get,update,delete | ||Insurances|| | CriticalIllnessInsuranceForPersonService | /scenarios/{scenarioId}/persons/{personId}/persons/${personId}/insurances/critical-illness/ |queryForPerson,getForPerson,createForPerson,updateForPerson,deleteForPerson | | DisabilityInsuranceForPersonService | /scenarios/{scenarioId}/persons/{personId}/persons/${personId}/insurances/disability/ |queryForPerson,getForPerson,createForPerson,updateForPerson,deleteForPerson | | LifeInsuranceForPersonService | /scenarios/{scenarioId}/persons/{personId}/persons/${personId}/insurances/life/ |queryForPerson,getForPerson,createForPerson,updateForPerson,deleteForPerson | | MortgageLifeInsuranceForPersonService | /scenarios/{scenarioId}/persons/{personId}/persons/${personId}/insurances/mortgage-life/ |queryForPerson,getForPerson,createForPerson,updateForPerson,deleteForPerson | ||Financial Reference Data|| | FinancialAssetClassService | /scenarios/reference/assets/financial/classes/ |query | | FinancialAssetProfileService | /scenarios/reference/assets/financial/profiles/ |query | | FinancialAssetWrapperService | /scenarios/reference/assets/financial/wrappers/ |query | ||Scenario|| | ScenarioService | /scenarios/{scenarioId}/ |query,get,create,load,update,clone,replace,execute,diagnose,diff | ||Security|| | LoginService | /uaa/login/ |login,loginUser | | RegistrationService | /uaa/register/ |register | | TokenService | /uaa/token/ | getClientToken,refresh,revoke| | ResetPasswordService | /uaa/reset/ | resetPassword | | TermsOfUseService | /uaa/terms-of-use/ |getCurrent,query,get,getAcceptance,create,update,updateAcceptance,delete | ||Simulation results|| | ResultsService | /results/{scenarioId}/query/results |get | | DiagnosticResultsService | /results/{scenarioId}/query/diagnostics/ |get | --- _Source: https://npm.io/package/@envizage/services · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._