# Client blockchain wallets
## Returns the list of blockchain wallets of a client.
> The blockchain wallets are sorted by creation date, in descending order. The most recently created blockchain wallets appear first.
```json
{"openapi":"3.1.0","info":{"title":"Rialto Manager API","version":"1.0.0"},"servers":[{"url":"https://api.rialtobridge.xyz/api/manager/v1","description":"Main (production) server for the Rialto Manager API"},{"url":"https://staging.api.rialtobridge.xyz/api/manager/v1","description":"Test (staging) server for the Rialto Manager API"},{"url":"http://localhost:3002/api/manager/v1","description":"Development server for the Rialto Manager API"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","name":"RIALTO_API_KEY","in":"header"}},"schemas":{"BlockchainWallet":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The unique identifier of the blockchain wallet."},"label":{"type":["string","null"],"description":"The label of the blockchain wallet."},"blockchainNetwork":{"type":"string","description":"The blockchain network of the wallet. See [the list of supported](https://docs.rialtobridge.xyz/concepts) blockchains."},"address":{"type":"string","description":"The address of the blockchain wallet."},"createdAt":{"type":"string","format":"date-time","description":"The creation date of the blockchain wallet."},"approvedAt":{"type":["string","null"],"format":"date-time","description":"The date when the blockchain wallet was approved.
Only present if the blockchain wallet aws approved.\n"},"deletedAt":{"type":["string","null"],"format":"date-time","description":"The date when the blockchain wallet was deleted.
Only present if the blockchain wallet was deleted.\n"}}}}},"paths":{"/clients/{clientId}/blockchain-wallets":{"get":{"summary":"Returns the list of blockchain wallets of a client.","description":"The blockchain wallets are sorted by creation date, in descending order. The most recently created blockchain wallets appear first.","operationId":"getClientBlockchainWallets","tags":["Client blockchain wallets"],"parameters":[{"name":"clientId","in":"path","required":true,"description":"The unique identifier of the client.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"A JSON array of blockchain wallets.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/BlockchainWallet"}}}}},"401":{"description":"Invalid API key"},"500":{"description":"An unexpected error occurred."}}}}}}
```
## Request the creation of a blockchain wallet.
> Creates a blockchain wallet with the specified parameters.\
The blockchain wallet is created in a pending state and must be approved by an administrator before it can be used in transactions.\
This route is \*\*only available for verified clients\*\*. Unverified clients will receive a 400 error.
```json
{"openapi":"3.1.0","info":{"title":"Rialto Manager API","version":"1.0.0"},"servers":[{"url":"https://api.rialtobridge.xyz/api/manager/v1","description":"Main (production) server for the Rialto Manager API"},{"url":"https://staging.api.rialtobridge.xyz/api/manager/v1","description":"Test (staging) server for the Rialto Manager API"},{"url":"http://localhost:3002/api/manager/v1","description":"Development server for the Rialto Manager API"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","name":"RIALTO_API_KEY","in":"header"}},"requestBodies":{"CreateBlockchainWallet":{"required":true,"description":"The parameters to create a blockchain wallet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateBlockchainWalletPayload","required":["blockchainNetwork","address"]}}}}},"schemas":{"CreateBlockchainWalletPayload":{"type":"object","properties":{"label":{"type":["string","null"],"description":"The label of the blockchain wallet."},"blockchainNetwork":{"type":"string","description":"The blockchain network of the wallet. See [the list of supported](https://docs.rialtobridge.xyz/concepts) blockchains."},"address":{"type":"string","description":"The address of the blockchain wallet."}}},"BlockchainWallet":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The unique identifier of the blockchain wallet."},"label":{"type":["string","null"],"description":"The label of the blockchain wallet."},"blockchainNetwork":{"type":"string","description":"The blockchain network of the wallet. See [the list of supported](https://docs.rialtobridge.xyz/concepts) blockchains."},"address":{"type":"string","description":"The address of the blockchain wallet."},"createdAt":{"type":"string","format":"date-time","description":"The creation date of the blockchain wallet."},"approvedAt":{"type":["string","null"],"format":"date-time","description":"The date when the blockchain wallet was approved.
Only present if the blockchain wallet aws approved.\n"},"deletedAt":{"type":["string","null"],"format":"date-time","description":"The date when the blockchain wallet was deleted.
Only present if the blockchain wallet was deleted.\n"}}}}},"paths":{"/clients/{clientId}/blockchain-wallets":{"post":{"summary":"Request the creation of a blockchain wallet.","description":"Creates a blockchain wallet with the specified parameters.
The blockchain wallet is created in a pending state and must be approved by an administrator before it can be used in transactions.
This route is **only available for verified clients**. Unverified clients will receive a 400 error.\n","operationId":"createClientBlockchainWallet","tags":["Client blockchain wallets"],"parameters":[{"name":"clientId","in":"path","required":true,"description":"The unique identifier of the client.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"$ref":"#/components/requestBodies/CreateBlockchainWallet"},"responses":{"201":{"description":"The blockchain wallet has been created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlockchainWallet"}}}},"400":{"description":"The request is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","description":"The reason why the request is invalid."},"parameterErrors":{"type":["object","null"],"description":"The errors related to the parameters of the request.
The object is null if there is no error related to the parameters.\n"}}}}}},"401":{"description":"Invalid API key"},"500":{"description":"An unexpected error occurred."}}}}}}
```
## Returns a blockchain wallet by ID.
> Returns a blockchain wallet by its unique identifier.
```json
{"openapi":"3.1.0","info":{"title":"Rialto Manager API","version":"1.0.0"},"servers":[{"url":"https://api.rialtobridge.xyz/api/manager/v1","description":"Main (production) server for the Rialto Manager API"},{"url":"https://staging.api.rialtobridge.xyz/api/manager/v1","description":"Test (staging) server for the Rialto Manager API"},{"url":"http://localhost:3002/api/manager/v1","description":"Development server for the Rialto Manager API"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","name":"RIALTO_API_KEY","in":"header"}},"schemas":{"BlockchainWallet":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The unique identifier of the blockchain wallet."},"label":{"type":["string","null"],"description":"The label of the blockchain wallet."},"blockchainNetwork":{"type":"string","description":"The blockchain network of the wallet. See [the list of supported](https://docs.rialtobridge.xyz/concepts) blockchains."},"address":{"type":"string","description":"The address of the blockchain wallet."},"createdAt":{"type":"string","format":"date-time","description":"The creation date of the blockchain wallet."},"approvedAt":{"type":["string","null"],"format":"date-time","description":"The date when the blockchain wallet was approved.
Only present if the blockchain wallet aws approved.\n"},"deletedAt":{"type":["string","null"],"format":"date-time","description":"The date when the blockchain wallet was deleted.
Only present if the blockchain wallet was deleted.\n"}}}}},"paths":{"/clients/{clientId}/blockchain-wallets/{blockchainWalletId}":{"get":{"summary":"Returns a blockchain wallet by ID.","description":"Returns a blockchain wallet by its unique identifier.","operationId":"getClientBlockchainWalletById","parameters":[{"name":"clientId","in":"path","required":true,"description":"The unique identifier of the client.","schema":{"type":"string","format":"uuid"}},{"name":"blockchainWalletId","in":"path","required":true,"description":"The unique identifier of the blockchain wallet.","schema":{"type":"string","format":"uuid"}}],"tags":["Client blockchain wallets"],"responses":{"200":{"description":"A blockchain wallet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlockchainWallet"}}}},"401":{"description":"Invalid API key"},"404":{"description":"Blockchain wallet not found."},"500":{"description":"An unexpected error occurred."}}}}}}
```
## Deletes a blockchain wallet by ID.
> Deletes a blockchain wallet by its unique identifier.\
A deleted blockchain wallet will still be returned in the list of blockchain wallets of the client or queriable by ID, but it will have a non null \`deletedAt\` field.\
A deleted blockchain wallet can not be used in transactions.\
This route is \*\*only available for verified clients\*\*. Unverified clients will receive a 400 error.
```json
{"openapi":"3.1.0","info":{"title":"Rialto Manager API","version":"1.0.0"},"servers":[{"url":"https://api.rialtobridge.xyz/api/manager/v1","description":"Main (production) server for the Rialto Manager API"},{"url":"https://staging.api.rialtobridge.xyz/api/manager/v1","description":"Test (staging) server for the Rialto Manager API"},{"url":"http://localhost:3002/api/manager/v1","description":"Development server for the Rialto Manager API"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","name":"RIALTO_API_KEY","in":"header"}},"schemas":{"BlockchainWallet":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The unique identifier of the blockchain wallet."},"label":{"type":["string","null"],"description":"The label of the blockchain wallet."},"blockchainNetwork":{"type":"string","description":"The blockchain network of the wallet. See [the list of supported](https://docs.rialtobridge.xyz/concepts) blockchains."},"address":{"type":"string","description":"The address of the blockchain wallet."},"createdAt":{"type":"string","format":"date-time","description":"The creation date of the blockchain wallet."},"approvedAt":{"type":["string","null"],"format":"date-time","description":"The date when the blockchain wallet was approved.
Only present if the blockchain wallet aws approved.\n"},"deletedAt":{"type":["string","null"],"format":"date-time","description":"The date when the blockchain wallet was deleted.
Only present if the blockchain wallet was deleted.\n"}}}}},"paths":{"/clients/{clientId}/blockchain-wallets/{blockchainWalletId}":{"delete":{"summary":"Deletes a blockchain wallet by ID.","description":"Deletes a blockchain wallet by its unique identifier.
A deleted blockchain wallet will still be returned in the list of blockchain wallets of the client or queriable by ID, but it will have a non null `deletedAt` field.
A deleted blockchain wallet can not be used in transactions.
This route is **only available for verified clients**. Unverified clients will receive a 400 error.\n","operationId":"deleteClientBlockchainWalletById","parameters":[{"name":"clientId","in":"path","required":true,"description":"The unique identifier of the client.","schema":{"type":"string","format":"uuid"}},{"name":"blockchainWalletId","in":"path","required":true,"description":"The unique identifier of the blockchain wallet.","schema":{"type":"string","format":"uuid"}}],"tags":["Client blockchain wallets"],"responses":{"200":{"description":"The blockchain wallet has been deleted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlockchainWallet"}}}},"400":{"description":"The request is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","description":"The reason why the request is invalid."}}}}}},"401":{"description":"Invalid API key"},"404":{"description":"Blockchain wallet not found."},"500":{"description":"An unexpected error occurred."}}}}}}
```