# Unplace Account Lien

<mark style="color:green;">`POST`</mark> `/api/accountlien/v1/unplacelien`\
\
The request body should include the required lien `id` or the `referenceNumber`.\
\
A successful request will return a confirmation message indicating that the lien has been removed along with any relevant details.\
\
This process allows for the secure and efficient removal of liens on accounts, ensuring that accurate and updated financial information is maintained while adhering to regulatory requirements.

{% hint style="info" %}
To remove a lien on an account, either the `id` or the `referenceNumber` must be used.
{% endhint %}

**Headers**

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

**Body**

<table><thead><tr><th width="168">Name</th><th width="173">Data Type (length)</th><th width="113" data-type="checkbox">Required</th><th>Description</th></tr></thead><tbody><tr><td><code>id</code></td><td>string</td><td>true</td><td>The unique identifier of the lien (GUID)</td></tr><tr><td><code>referenceNumber</code></td><td>string (<a data-footnote-ref href="#user-content-fn-1"><em>500)</em></a></td><td>false</td><td>A unique reference number for the lien, if available<br></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 --request PUT '{{baseurl}}/api/accountlien/v1/unplacelien' \
--header 'Authorization: bearer {token}' \
--header 'request-reference: {unique_reference}' \
--header 'Content-Type: application/json' \
--data ''
```

</details>

<details>

<summary>Respose: <code>200</code></summary>

```json
{
  "status": true,
  "message": "string"
}
```

</details>

[^1]: This is the maximum number of characters allowed.
