.png)
Retrieves a single recipient.
ENDPOINTS
get
/v1/recipients/{recipientId}
Header parameters
Collapse
callingAppId
string
no
The id of the app or service calling the recipients service.
Authorization
string
required
An OAuth2 access token (in JWT format) that authorizes this request. The transactions:read and accounts:read scopes are required to access this API. Must be in the format Bearer {JWT}
transactionId
string
required
An ID that identifies this request. A unique identifier should be generated for each request made.
Body parameters
Collapse
Path parameters
Collapse
recipientId
string
required
The ID of the recipient to be retrieved.
Responses
Collapse
200
Success
Response Body
{"recipients":[{"id":"string","institutionId":"string","institutionCustomerId":"string","memberNumber":"string","accountNumber":"string","accountType":"SAVINGS","passCode":"string","email":"string","nickName":"string","fullName":"string"}]}
400
Bad request
Response Body
{"code":"string","message":"string"}
401
Unauthorized Possible causes: - Full authentication was not provided in the request. - The authentication token that was sent in the request is invalid.
Response Body
{"code":"string","message":"string"}
403
Forbidden Possible causes: - The authentication provided does not authorize this request.
Response Body
{"code":"string","message":"string"}
500
Server error
Response Body
{"code":"string","message":"string"}
curl -X 'GET' \
'https://api.candescent.com/digitalbanking/db-recipients/v1/recipients/{recipientId}' \
-H 'transactionid: SOME_STRING_VALUE' \
-H 'authorization: SOME_STRING_VALUE' \
-H 'callingappid: SOME_STRING_VALUE' \
-H 'accept: application/json' \