Get Card By Id

get https://api.cloud.mbanq.com/v1/cards/{card-id}

Use this API to get the card details. You need to specify the card Id in the API.

This API endpoint allows you to fetch detailed information about a specific card using its unique card Id.

By specifying the card Id in the request, you will obtain a complete profile of the card, including its current status, type, expiration date, and associated account details.

This is particularly useful for tracking card activity, verifying card attributes, and managing individual card records.

Behaviour : A successful response from this API indicates that the card details were successfully retrieved.

Responses

Response body

object

integer

The unique identifier of the card.
Example: 3

accountId

integer

The identifier of the associated account.
Example: 12

productId

integer

The identifier of the card product.
Example: 4

virtual

boolean

Indicates if the card is virtual.
Example: false

productName

string

The name of the card product.
Example: testDebit2

network

string

The network of the card.
Example: MASTERCARD

cardType

string

The type of card.
Example: DEBIT

digitalFirst

boolean

Indicates if the card is digital first.
Example: false

cardProcessorName

string

The name of the card processor.
Example: galileo

token

string

The token associated with the card.
Example: 566e05a9-431d-462e-8692-67ff011f9dc5

embossedNames

array of strings

The names embossed on the card.
Example: ["Alexa Smart"]

embossedNames

primaryAccountNumber

string

The primary account number of the card.
Example: ************3456

expiresOn

array of integers

The expiration date of the card [year, month, day].
Example: [2028, 6, 30]

expiresOn

status

string

The status of the card.
Possible status: ORDER_IN_PROGRESS, ORDER_FAILED, CREATED, REJECTED, ORDERED, INACTIVE, ACTIVE, SUSPENDED, TERMINATED, REPLACED, RENEWED, EXPIRED, LOST_STOLEN, RETURNED, PENDING, DELETED.
Example: REPLACED

onlinePaymentEnabled

boolean

Indicates if online payments are enabled for the card.
Example: false

posPaymentEnabled

boolean

Indicates if POS payments are enabled for the card.
Example: false

physicalCardActivated

boolean

Indicates if the physical card is activated.
Example: false

contactlessPaymentEnabled

boolean

Indicates if contactless payments are enabled for the card.
Example: false

atmWithdrawalsEnabled

boolean

Indicates if ATM withdrawals are enabled for the card.
Example: false

internationalPaymentsEnabled

boolean

Indicates if international payments are enabled for the card.
Example: false

velocityRules

string

The velocity rules associated with the card.
Example: []

registeredOn

array of integers

The date the card was registered [year, month, day].
Example: [2023, 6, 27]

registeredOn

activatedAt

object

date

integer

The date the card was activated [year, month, day].
Example: [2023, 6, 28]

time

integer

The hour the card was activated.
Example: 4

updatedStatusBy

object

integer

The identifier of the user who updated the status.
Example: 1

username

string

The username of the user who updated the status.
Example: admin

officeId

integer

The office ID of the user who updated the status.
Example: 1

officeName

string

The office name of the user who updated the status.
Example: Head Office

firstname

string

The first name of the user who updated the status.
Example: App

lastname

string

The last name of the user who updated the status.
Example: Administrator

string

The email of the user who updated the status.
Example: documents@gwocu.com

isEmailVerified

boolean

Indicates if the user's email is verified.
Example: true

isSelfServiceUser

boolean

Indicates if the user is a self-service user.
Example: false

updatedStatusAt

string

The date and time when the card status was updated.
Example: 2023-06-28T04:57:30.610685

bid

integer

The bid associated with the card.
Example: 12345

replacedDamageCount

integer

The count of times the card has been replaced due to damage.
Example: 0

user

object

integer

The identifier of the user associated with the card.
Example: 12

username

string

The username of the user associated with the card.
Example: alexa

officeId

integer

The office ID of the user associated with the card.
Example: 1

officeName

string

The office name of the user associated with the card.
Example: Head Office

firstname

string

The first name of the user associated with the card.
Example: Alexa

lastname

string

The last name of the user associated with the card.
Example: Smart

string

The email of the user associated with the card.
Example: documents@gwocu.com

isEmailVerified

boolean

Indicates if the user's email is verified.
Example: true

isSelfServiceUser

boolean

Indicates if the user is a self-service user.
Example: true

businessCardIDEnabled

boolean

Indicates if the business card ID is enabled.
Example: false

mergedVelocityRules

string

The merged velocity rules associated with the card.
Example: []

Language

Credentials

Bearer

JWT


xxxxxxxxxx
1
curl --request GET \
2
     --url 'https://api.cloud.mbanq.com/v1/cards/;card-id=1' \
3
     --header 'accept: application/json' \
4
     --header 'tenantId: z01j3e71zd6zkq908vyf5861a8'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Get card successfully.

404Card not found