Balance Check

To check a card balance, pass in the card_reference to the Cards query. You can add / remove fields available via our Schema if you want to streamline / see more detail on the card from the request.

API call

query Cards {
    Cards(card_reference: "6301190004871637839") {
        data {
            card_reference
            balance
            pin
            card_alias_card_reference
            initial_balance
            product_name
            first_top_up_value
            created_at
            used
            expiry_time
            validity_start_time
            ValueSplit {
                tender
                discount
            }
        }
    }
}

If no cards are found

If no cards are found for your query, the API will respond with blank JSON for “Data”:

{
    "data": {
        "Cards": {
            "data": []
        }
    },
    "extensions": {
        "cost": {
            "actualQueryCost": 16,
            "throttleStatus": {
                "maximumAvailable": 8000,
                "currentlyAvailable": 7986
            }
        }
    }
}