# Savings Accounts ## Map a person's main account to a savings account - [POST /v1/persons/{person_id}/deposit_accounts/{account_id}/mappings](https://docs.solarisgroup.com/api-reference/digital-banking/account-management/savings-accounts/paths/~1v1~1persons~1%7Bperson_id%7D~1deposit_accounts~1%7Baccount_id%7D~1mappings/post.md): Maps a person's savings account to their main (checking) account and then triggers the remaining steps for savings account onboarding. The person may only transfer money to and from their savings account using the main account mapped by this request. ## Map a business' main account to a savings account - [POST /v1/businesses/{business_id}/deposit_accounts/{account_id}/mappings](https://docs.solarisgroup.com/api-reference/digital-banking/account-management/savings-accounts/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1deposit_accounts~1%7Baccount_id%7D~1mappings/post.md): Maps a business' savings account to its main (checking) account and then triggers the remaining steps for savings account onboarding. The business may only transfer money to and from their savings account using the main account mapped by this request. ## Create pay-in to a person's savings account - [POST /v1/persons/{person_id}/deposit_accounts/{account_id}/payin](https://docs.solarisgroup.com/api-reference/digital-banking/account-management/savings-accounts/paths/~1v1~1persons~1%7Bperson_id%7D~1deposit_accounts~1%7Baccount_id%7D~1payin/post.md): Transfers money from a person's main account to their savings account. ## Create pay-in to a business' savings account - [POST /v1/businesses/{business_id}/deposit_accounts/{account_id}/payin](https://docs.solarisgroup.com/api-reference/digital-banking/account-management/savings-accounts/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1deposit_accounts~1%7Baccount_id%7D~1payin/post.md): Transfers money from a business' main account to its savings account. ## Create payout from a person's savings account - [POST /v1/persons/{person_id}/deposit_accounts/{account_id}/payout](https://docs.solarisgroup.com/api-reference/digital-banking/account-management/savings-accounts/paths/~1v1~1persons~1%7Bperson_id%7D~1deposit_accounts~1%7Baccount_id%7D~1payout/post.md): Transfers money from a person's savings account to their main account. ## Create payout from a business' savings account - [POST /v1/businesses/{business_id}/deposit_accounts/{account_id}/payout](https://docs.solarisgroup.com/api-reference/digital-banking/account-management/savings-accounts/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1deposit_accounts~1%7Baccount_id%7D~1payout/post.md): Transfers money from a business' savings account to its main account. ## Create tax exemption order for a person - [POST /v1/persons/{person_id}/deposit_accounts/{account_id}/tax_exemptions](https://docs.solarisgroup.com/api-reference/digital-banking/account-management/savings-accounts/paths/~1v1~1persons~1%7Bperson_id%7D~1deposit_accounts~1%7Baccount_id%7D~1tax_exemptions/post.md): Creates a tax exemption order for a person's savings account, specified in the request URL by its ID. Specify the amount to be exempted from tax in the request body. ## Update a person's tax exemption order - [PATCH /v1/persons/{person_id}/deposit_accounts/{account_id}/tax_exemptions](https://docs.solarisgroup.com/api-reference/digital-banking/account-management/savings-accounts/paths/~1v1~1persons~1%7Bperson_id%7D~1deposit_accounts~1%7Baccount_id%7D~1tax_exemptions/patch.md): Modifies the time period and/or tax-exempt amount of a person's tax exemption order. ## Retrieve a person's tax exemption order - [GET /v1/persons/{person_id}/deposit_accounts/{account_id}/tax_exemptions](https://docs.solarisgroup.com/api-reference/digital-banking/account-management/savings-accounts/paths/~1v1~1persons~1%7Bperson_id%7D~1deposit_accounts~1%7Baccount_id%7D~1tax_exemptions/get.md): Returns the tax exemption order for the person specified in the request URL. ## Remove a person's tax exemption order - [DELETE /v1/persons/{person_id}/deposit_accounts/{account_id}/tax_exemptions](https://docs.solarisgroup.com/api-reference/digital-banking/account-management/savings-accounts/paths/~1v1~1persons~1%7Bperson_id%7D~1deposit_accounts~1%7Baccount_id%7D~1tax_exemptions/delete.md): Deletes the tax exemption order for the person specified in the request URL. Note that you should only use this endpoint for or tax exemption orders that were Please use to close previously utilized tax exemption orders. ## Close a person's tax exemption order - [PATCH /v1/persons/{person_id}/deposit_accounts/{account_id}/tax_exemptions/close](https://docs.solarisgroup.com/api-reference/digital-banking/account-management/savings-accounts/paths/~1v1~1persons~1%7Bperson_id%7D~1deposit_accounts~1%7Baccount_id%7D~1tax_exemptions~1close/patch.md): Closes the tax exemption order for the person specified in the request URL. Note that you should only use this endpoint for previously utilized tax exemption orders. To delete or tax exemption orders that were please use DELETE Remove a person's tax exemption order. ## Request the utilization details of a person's tax exemption order - [POST /v1/persons/{person_id}/deposit_accounts/{account_id}/tax_exemptions/utilization](https://docs.solarisgroup.com/api-reference/digital-banking/account-management/savings-accounts/paths/~1v1~1persons~1%7Bperson_id%7D~1deposit_accounts~1%7Baccount_id%7D~1tax_exemptions~1utilization/post.md): Submits a request to retrieve the tax exemption utilization details for the person and the savings account specified in the request URL. This endpoint will return a response body with only the ID of the request. The utilization details will be sent asynchronously via the 'TAX_EXEMPTION_UTILIZATION' webhook event after the request is successfully processed. ## Get interest details for a person's savings account - [GET /v1/persons/{person_id}/deposit_accounts/{account_id}/interest_details](https://docs.solarisgroup.com/api-reference/digital-banking/account-management/savings-accounts/paths/~1v1~1persons~1%7Bperson_id%7D~1deposit_accounts~1%7Baccount_id%7D~1interest_details/get.md): Returns the interest details for a person's savings account, specified in the request URL by its ID. The response includes the interest rate, the amount of interest accrued, and the date when the interest calculator was last run for the account. ## Get interest details for a business' savings account - [GET /v1/businesses/{business_id}/deposit_accounts/{account_id}/interest_details](https://docs.solarisgroup.com/api-reference/digital-banking/account-management/savings-accounts/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1deposit_accounts~1%7Baccount_id%7D~1interest_details/get.md): Returns the interest details for a business' savings account, specified in the request URL by its ID. The response includes the interest rate, the amount of interest accrued, and the date when the interest calculator was last run for the account.