# External accounts

**External account** API operations are used to connect to a third party custodian, typically a trading venue, to instruct trading orders directly from Ripple Custody. The following calls allow to setup a connection with an external provider, list the external accounts and their balances.

## Connect an external account provider

 - [POST /v1/domains/{domainId}/external-accounts/providers](https://docs.ripple.com/products/custody/v1.19/api/reference/openapi/external-accounts/paths/~1v1~1domains~1%7Bdomainid%7D~1external-accounts~1providers/post.md): Connect an external account provider

## List external account provider connections

 - [GET /v1/domains/{domainId}/external-accounts/providers](https://docs.ripple.com/products/custody/v1.19/api/reference/openapi/external-accounts/paths/~1v1~1domains~1%7Bdomainid%7D~1external-accounts~1providers/get.md): List external account provider connections

## Update an external account provider connection

 - [POST /v1/domains/{domainId}/external-accounts/providers/{connectionId}](https://docs.ripple.com/products/custody/v1.19/api/reference/openapi/external-accounts/paths/~1v1~1domains~1%7Bdomainid%7D~1external-accounts~1providers~1%7Bconnectionid%7D/post.md): Update an external account provider connection

## Get external account provider connections

 - [GET /v1/domains/{domainId}/external-accounts/providers/{connectionId}](https://docs.ripple.com/products/custody/v1.19/api/reference/openapi/external-accounts/paths/~1v1~1domains~1%7Bdomainid%7D~1external-accounts~1providers~1%7Bconnectionid%7D/get.md): Get external account provider connections

## Disconnect an external account provider

 - [DELETE /v1/domains/{domainId}/external-accounts/providers/{connectionId}](https://docs.ripple.com/products/custody/v1.19/api/reference/openapi/external-accounts/paths/~1v1~1domains~1%7Bdomainid%7D~1external-accounts~1providers~1%7Bconnectionid%7D/delete.md): Disconnect an external account provider

## List external accounts

 - [GET /v1/domains/{domainId}/external-accounts](https://docs.ripple.com/products/custody/v1.19/api/reference/openapi/external-accounts/paths/~1v1~1domains~1%7Bdomainid%7D~1external-accounts/get.md): List external accounts

## Get external account details

 - [GET /v1/domains/{domainId}/external-accounts/{externalAccountId}](https://docs.ripple.com/products/custody/v1.19/api/reference/openapi/external-accounts/paths/~1v1~1domains~1%7Bdomainid%7D~1external-accounts~1%7Bexternalaccountid%7D/get.md): Get external account details

## Get external account balances

 - [GET /v1/domains/{domainId}/external-accounts/{externalAccountId}/balances](https://docs.ripple.com/products/custody/v1.19/api/reference/openapi/external-accounts/paths/~1v1~1domains~1%7Bdomainid%7D~1external-accounts~1%7Bexternalaccountid%7D~1balances/get.md): Get external account balances

## Retrieve latest external address

 - [GET /v1/domains/{domainId}/external-accounts/{externalAccountId}/addresses/latest](https://docs.ripple.com/products/custody/v1.19/api/reference/openapi/external-accounts/paths/~1v1~1domains~1%7Bdomainid%7D~1external-accounts~1%7Bexternalaccountid%7D~1addresses~1latest/get.md): Retrieve latest external address

## Retrieve all generated addresses

 - [GET /v1/domains/{domainId}/external-accounts/{externalAccountId}/addresses](https://docs.ripple.com/products/custody/v1.19/api/reference/openapi/external-accounts/paths/~1v1~1domains~1%7Bdomainid%7D~1external-accounts~1%7Bexternalaccountid%7D~1addresses/get.md): Retrieve all generated addresses

## Generate new account external address

 - [POST /v1/domains/{domainId}/external-accounts/{externalAccountId}/addresses](https://docs.ripple.com/products/custody/v1.19/api/reference/openapi/external-accounts/paths/~1v1~1domains~1%7Bdomainid%7D~1external-accounts~1%7Bexternalaccountid%7D~1addresses/post.md): Generate new account external address

## Retrieve account external address

 - [GET /v1/domains/{domainId}/external-accounts/{externalAccountId}/addresses/{externalAccountAddressId}](https://docs.ripple.com/products/custody/v1.19/api/reference/openapi/external-accounts/paths/~1v1~1domains~1%7Bdomainid%7D~1external-accounts~1%7Bexternalaccountid%7D~1addresses~1%7Bexternalaccountaddressid%7D/get.md): Retrieve account external address