# Linked Accounts

Notification that the status of a Linked Account has been updated.

## Get Linked accounts

 - [GET /v1/linked_accounts](https://api.weavr.io/products/payment-run/openapi/linked-accounts/getlinkedaccounts.md): Retrieves the linked accounts belonging to the buyer that the logged-in user belongs to.


Required user role: CONTROLLER

## Get Linked account

 - [GET /v1/linked_accounts/{linked_account_id}](https://api.weavr.io/products/payment-run/openapi/linked-accounts/getlinkedaccountsid.md): Retrieves a linked account of the buyer that the logged-in user belongs to.


Required user role: CONTROLLER

## Update a linked account

 - [PATCH /v1/linked_accounts/{linked_account_id}](https://api.weavr.io/products/payment-run/openapi/linked-accounts/patchlinkedaccountsid.md): Updates properties of a linked account such as friendly name.

Required user role: CONTROLLER

## Unlink a linked account

 - [POST /v1/linked_accounts/{linked_account_id}/unlink](https://api.weavr.io/products/payment-run/openapi/linked-accounts/unlinklinkedaccountsid.md): Unlinks a linked account identified by the linked_account_id.

This action is not reversible and if the buyer wants to use this linked account again to fund payment runs, they will have to re-link the account. More information on how to link an account can be found here.

Details of an unlinked account, can still be retrieved via the Get linked accounts and Get linked account endpoints.


Required user role: CONTROLLER