Skip to main content

Get the card balance

This operations allow you to query a card balance and recent transactions information.

HTTP Request

GET /cards/balance

Header Parameters

HeaderDescription
Authorization 
required
The Bearer token created in
Get authorization Token
Content-Type 
required
application/json

Query parameters

ParameterTypePatternDescription
card_number 
required
string16 digits* or uuidThe card_number or card_id to be requested.
movements 
required
booleantrue or falseSet if you want the last movements.
note

*If card_number is sended as 16 digits, it must be sended ciphered and Base 64 Encoded with URL and Filename Safe Alphabet. See Data encryption & encoding.

Example JSON Request:

GET /cards/balance?card_number=11111111-daa7-1234-aaaa-123123123ecd&movements=true

Example JSON Response:

{
"success": true,
"code": 0,
"message": "OK",
"data": {
"available": 500,
"card": {
"id": "11111111-daa7-1234-aaaa-123123123ecd",
"masked_card_number": "************1234",
"type": "PHYSICAL",
"status": "ACTIVE"
},
"account": {
"id": "12312312-1234-1234-1234-123456123123",
"reference": "555555555"
},
"movements": [ {
"fecha": "20201214",
"hora": "195550",
"comercio": "FINPULSO SAPI",
"importe": "350.11",
"descripcion_importe": null,
"codigo_autorizacion": "504884"
}
]
}
}