> 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/fixed-deposit-account/top-up.md).

# Top Up

The "Top Up" endpoint allows customers to add funds to an existing fixed deposit account.

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

To top up a fixed deposit, 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>accountNumber</td><td>string (50)</td><td>true</td><td>This is the Savings Account Number that will be credited.<br><br><em>This is not the Liquidation Account.</em></td></tr><tr><td>instrumentNumber</td><td>string (100)</td><td>true</td><td>The instrument number of the fixed deposit account to be topped up.<br><br><em>Used to prevent duplicate requests.</em></td></tr><tr><td>topUpAmount</td><td>number</td><td>true</td><td>The amount to be topped up into the fixed deposit account.<br><br><em>The amount should be sent in the base unit of the currency. For example, 1000 naira will be sent as 1000 * 100.</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/fixeddepositaccount/v1/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>Respose: <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>