GET
/
v4
/
account
/
{accountId}
{
  "embossing": {
    "companyName": "string",
    "firstName": "string",
    "lastName": "string"
  },
  "productCode": "MC_CARD_2, VISA_CARD1, VISA_VIRTUAL_3, MC_VIRTUAL_2, VISA_CARD"
}

{
  "embossing": {
    "companyName": "string",
    "firstName": "string",
    "lastName": "string"
  },
  "productCode": "MC_CARD_2, VISA_CARD1, VISA_VIRTUAL_3, MC_VIRTUAL_2, VISA_CARD"
}

Path Parameters

​
accountId
string<biginteger>
required

The account id to fetch list of cards for

Query Parameters

​
auditUser
string
required

The audit user to log the request

​
page
integer
default:0

Current page

​
size
integer
default:30

How many cards should be returned per page, default is 30. Cannot be more than 100.

Required range: 1 < x < 100

Response

Successful lookup of cards

​
embossing
object
​
productCode
string

This field is used when the institution has multiple card products setup. The productCode is used to determine the specific card product. Use of this field as well as the values of the field, is dependent on institution setup and should be aligned with Enfuce prior to use.

Example:

"MC_CARD_2, VISA_CARD1, VISA_VIRTUAL_3, MC_VIRTUAL_2, VISA_CARD"

​
customerId
string

The customer id card is linked to

Example:

"1234567890"

​
id
string

Unique card id for given card

Example:

"1234567890"

​
template
string

Template name for which the card is connected to

​
accountId
string

The account id card is linked to

Example:

"1234567890"

​
cardRole
enum<string>

A role needs to be provided for the connection to the account. Role is one way to categorize between primary and supplementary card holders. Role MAIN will always create a card to have same account holder and card holder. For a supplementary card there is a possibility to differ between account and card holder.

Available options:
MAIN,
SUPPLEMENTARY
​
status
enum<string>
  • CARD_OK - Card is open and in normal status. Card has to be in this status in order for it to be renewed - CARD_BLOCKED - Temporary block on the card that will prevent approval of authorisations. Can be used instead of account level temporary block if target is to block only a specific card - SUSPECTED_FRAUD - Temporary block on the card that will prevent approval of authorisations. Functionality the same as for "Card blocked", the different code allows to differentiate between the blocks - CARD_CLOSED_DUE_TO_FRAUD - Used to close a card due to known fraud - CARD_NO_RENEWAL - Status set to prevent following card renewal. Does not affect card functionality in any way, only renewal - CARD_LOST - Used to close a card because it is lost - CARD_STOLEN - Used to close a card because it is stolen - CARD_CLOSED - Used to close card by request from customer or bank, reason for closure is set with status update reason. Allows still clearing transaction posting - CARD_EXPIRED - Final card closure status, that blocks also clearing transaction posting
Available options:
CARD_OK,
CARD_BLOCKED,
SUSPECTED_FRAUD,
CARD_CLOSED_DUE_TO_FRAUD,
CARD_NO_RENEWAL,
CARD_LOST,
CARD_STOLEN,
CARD_CLOSED,
CARD_EXPIRED
​
maskedCardNumber
string

Card number, masked in order to protect sensitive data

Example:

"123456______4285"

​
statusDate
string<date-time>

Last updated on

Example:

"2020-05-12T13:18:05"