Retrieve a Card
The Retrieve Card endpoint enables you to return details for a card based on the Public Token in the URL. Details included in a successful response include the status of the card, the current balance, and the control groups the card is associated with.
You can retrieve card details by making a GET request to the Retrieve Card endpoint. For example:
{{base-url}}/cards/{{publicToken}}
A successful response will return a HTTP 200 response code. Below is an example response:
{
"cardType": "Physical",
"publicToken": "638050230",
"status": "Active",
"cardStatusCode": "00",
"cardStatusDescription": "00 (Active)",
"balance": {
"currencyCode": "GBP",
"cardBalance": 300.67,
"pendingAmount": -74,
"availableBalance": 226.67
},
"cardDetails": {
"customerReference": "",
"fullNameOnCard": "Mr John Smith",
"maskedPan": "529955******4384",
"startDate": "2022-09-28",
"expiryDate": "2023-09-28"
},
"cardHolder": {
"title": "Mr",
"firstName": "John",
"middleName": "",
"lastName": "Smith",
"dateOfBirth": "1963-11-22",
"mobile": "",
"email": ""
},
"cardProduct": {
"scheme": "Sandbox Scheme",
"product": 1234,
"productShortName": "Sandbox"
},
"controlGroups": {
"limitsGroup": 1,
"usageGroup": 0,
"recurringFeeGroup": 0,
"webServiceFeeGroup": -1,
"authFeeGroup": 0,
"mccGroup": 0,
"cardLinkageGroup": 0,
"calendarGroup": -1,
"fxGroup": 0,
"paymentTokenUsageGroup": 0
},
"3DS": [],
"designId": "Sandbox",
"childCards": [],
"siblingCards": [],
"address": {
"addressLine1": "32 Eastern Lane",
"addressLine2": "",
"addressLine3": "",
"city": "",
"state": "",
"county": "",
"postCode": "S11 7AA",
"country": "826"
},
"fulfilment": {
"addressLine1": "32 Eastern Lane",
"addressLine2": "",
"addressLine3": "",
"city": "",
"state": "",
"county": "",
"postCode": "S11 7AA",
"country": "826"
},
"freetext1": "Comments for the card manufacturer here",
"freetext2": "And in this field too.",
"IsSingleUse" : "true",
"IsNonReloadable" : "false",
"cardAcceptorIds": {
"allowCardAcceptors": [],
"disallowCardAcceptors": []
}
API Explorer
See the Retrieve a Card endpoint for more information.
Updated 8 months ago