# ledger

Ledger Operations

## Inter-Account Transfers

 - [POST /api/ledger/transfer](https://developer.xpansiv.com/openapi/nar-registry-client-v1/nar.client.v1.openapi/ledger/interaccounttransfer.md): Initiate certificate transfers to other registry account holders. Transfers must then be confirmed by the counterparty.

## Pending Transfer Actions

 - [POST /api/ledger/transfer/pending/action](https://developer.xpansiv.com/openapi/nar-registry-client-v1/nar.client.v1.openapi/ledger/actionpendingtransfers.md): Perform actions on pending transfers of monthly certificates between accounts (either incoming or outgoing). Note that actions for incoming and outgoing transfers can be included in the same submission.

## SubAccount Transfers

 - [POST /api/ledger/subaccountTransfer](https://developer.xpansiv.com/openapi/nar-registry-client-v1/nar.client.v1.openapi/ledger/subaccounttransfer.md): Initiate transfers of monthly certificates to other sub-accounts within an account.

## Retirements

 - [POST /api/ledger/retire](https://developer.xpansiv.com/openapi/nar-registry-client-v1/nar.client.v1.openapi/ledger/retire.md): Initiate retirements of monthly certificates within an account.

## Certificate Holdings

 - [GET /api/ledger/holding](https://developer.xpansiv.com/openapi/nar-registry-client-v1/nar.client.v1.openapi/ledger/getholdings.md): Retrieve the list of all monthly certificates held by the API user (hourly certificates are not included). This will return certificates belonging to the API user that are in active and retired states.

## Pending Transfers

 - [GET /api/ledger/transfer/pending](https://developer.xpansiv.com/openapi/nar-registry-client-v1/nar.client.v1.openapi/ledger/getpendingtransfers.md): Retrieve the list of all pending monthly certificate intra-registry transfers for Monthly vintage certificates for an account/accounts. Results do not include pending imports or export.