GET
/
v3
/
customer
/
{customerId}

Path Parameters

customerId
string
required

The customer 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.

Response

200 - application/json
accountId
string

The account id card is linked to

id
string

Unique card id for given card

customerId
string

The customer id card is linked to

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
truncatedCardNumber
string
Initiate card data retrievalGet cards given accountId