Get account details - ZEN transfers API

Endpoint is used to get the Customer account details by the unique account ID accountId. The parameter is returned in the endpoint to get the list of accounts.

The account parameters and balance are returned in response.

Create a GET request

WARNING

Request header with Authorization parameter is obliged for all requests sent to ZEN.COM API. Authorization value is the apiKey parameter which is generated and provided by ZEN.COM to the Client. This key is unique to each Customer and should not be shared or used by third parties.

Create a GET request.

Path parameters

Parameter	Description	Type	Required
`accountId`	unique account id	string ($uuid)	yes

💡

Example of JSON

Send the request

Send the GET request to:

test environment: https://api-services.zen-test.com/accounts/v1.0/{accountId}

production environment: https://api-services.zen.com/accounts/v1.0/{accountId}

Receive the ZEN.COM response

Receive the ZEN.COM response. The accountId returned in the response is used as the identifier of the account from which the payment is made.

Parameters

Parameter	Description	Type	Nullable
`accountId`	unique account id	string ($uuid)	no
`productName`	account type (related to its purpose)	string	no
`currencyCode`	account currency	string (ISO 4217 standard)	no
`balance`	accounting balance (not including account blockages)	number ($double)	no
`avaliableBalance`	available balance (including account blockages)	number ($double)	no
`alias`	account alias	string	yes

💡

Example response

{
   "accountId":"db29ac40-f2ab-4e60-a311-5171ed8f42f1",
   "productName":"Accounts for IND",
   "currencyCode":"EUR",
   "balance":"0.00",
   "availableBalance":"0.00",
   "alias":"ABCDE"
}

Errors

HTTP code	Business code	Description
400	`VALIDATION_ERROR`	the data has not been validated
403	`FORBIDDEN`	no access to the resource
404	`ACCOUNT_NOT_FOUND`	no account with the specified accountId was found
500	`INTERNAL_SERVER_ERROR`	server error, please contact ZEN

💡

Example error response

{
   "error":{
      "code":"INTERNAL_SERVER_ERROR",
      "message":"Unexpected error. Contact ZEN"
   }
}