> For the complete documentation index, see [llms.txt](https://docs.udara360.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.udara360.io/udara360-docs-1/savings/frequentsavings/top-up-frequent-savings.md).

# Top Up Frequent Savings

This endpoint allows customers to add funds to an existing frequent savings account.

<mark style="color:yellow;">`POST`</mark> `/api/savingsaccount/v1/frequentsavings/topup`

To top up a frequent savings account, you need to provide the necessary body parameters, such as `accountNumber`, `instrumentNumber`, and `topUpAmount`.

**Headers**

| Name                                                | Value                |
| --------------------------------------------------- | -------------------- |
| Content-Type<mark style="color:red;">\*</mark>      | `application/json`   |
| Authorization<mark style="color:red;">\*</mark>     | `Bearer`             |
| Request-Reference<mark style="color:red;">\*</mark> | `{unique_reference}` |

**Body**

<table><thead><tr><th>Name</th><th>Data Type (Length)</th><th data-type="checkbox">Required</th><th>Description</th></tr></thead><tbody><tr><td><code>accountNumber</code></td><td>string (50)</td><td>true</td><td>This is the Savings Account Number that will be credited.<br><br><em><mark style="color:red;">This is not the Liquidation Account.</mark></em></td></tr><tr><td><code>instrumentNumber</code></td><td>string (100)</td><td>true</td><td>The instrument number of the frequent savings account to be topped up.<br><br><em><mark style="color:red;">Used to prevent duplicate requests.</mark></em></td></tr><tr><td><code>topUpAmount</code></td><td>Integer</td><td>true</td><td>The amount to be topped up into the frequent savings account.<br><br><em><mark style="color:red;">The amount should be sent in the base unit of the currency. For example, 1000 naira will be sent as 1000 * 100</mark>.</em></td></tr></tbody></table>

Here is an example request and response with a sample payload sent to the endpoint in Curl format.

<details>

<summary>Sample Request</summary>

```json
curl --location -g '{{baseurl}}/api/savingsaccount/v1/frequentsavings/topup' \
--header 'Authorization: bearer {token}' \
--header 'request-reference: {unique_reference}' \
--header 'Content-Type: application/json' \
--data '{
  "accountNumber": "string",
  "instrumentNumber": "string",
  "topUpAmount": 0
}'
```

</details>

<details>

<summary>Response: <code>200</code></summary>

```json
{
  "status": true,
  "message": "string",
  "data": {
    "statusCode": "string",
    "referenceNumber": "string",
    "instrumentNumber": "string",
    "message": "string",
    "duration": "string",
    "sessionID": "string"
  },
  "isSuccessful": true,
  "statusCode": "string",
  "referenceNumber": "string",
  "instrumentNumber": "string",
  "duration": "string",
  "sessionID": "string"
}
```

</details>