Misc

Miscellaneous APIs that we think you might find useful

Get all cardholders

You can use this endpoint to get all the cardholders that have been created in your account.

curl --location --request GET 'https://issuecards.api.bridgecard.co/v1/issuing/sandbox/cards/get_all_cardholder?page=1' \
--header 'token: Bearer *****' \
--data-raw ''
Response

🟢 200: All issued cards have been fetched successfully

{
    "status": "success",
    "message": "All your cardholders have been fetched successfully",
    "data": {
        "cardholders": [
            {
                "address": {
                    "address": "9 Jibowu Street",
                    "city": "Aba North",
                    "country": "nigeria",
                    "house_no": "13",
                    "lga": "Aba North",
                    "postal_code": "1000242",
                    "state": "Abia"
                },
                "cardholder_id": "7da652e1bfc349d996dbfb811e1f3b45",
                "created_at": 1659921383,
                "email_address": "festusowumi@gmail.com",
                "first_name": "John",
                "identity_details": {
                    "blacklisted": false,
                    "date_of_birth": "1999-02-04",
                    "first_name": "John",
                    "gender": "Male",
                    "id_no": "22222222222",
                    "id_type": "NIGERIAN_NIN",
                    "last_name": "Doe",
                    "phone": "08123456789"
                },
                "is_active": true,
                "is_id_verified": true,
                "issuing_app_id": "842352f4-8a6f-4a19-89c6-4e8a240a2355",
                "last_name": "Doe",
                "phone": "2348164881733"
            },
            {
                "address": {
                    "address": "9 Jibowu Street",
                    "city": "Aba North",
                    "country": "nigeria",
                    "house_no": "13",
                    "lga": "Aba North",
                    "postal_code": "1000242",
                    "state": "Abia"
                },
                "cardholder_id": "13404fa9c96a4c43b7f0016b6243ace2",
                "created_at": 1659920777,
                "email_address": "festusowumi@gmail.com",
                "first_name": "John",
                "identity_details": {
                    "blacklisted": false,
                    "date_of_birth": "1999-02-04",
                    "first_name": "John",
                    "gender": "Male",
                    "id_no": "22222222222",
                    "id_type": "NIGERIAN_NIN",
                    "last_name": "Doe",
                    "phone": "08123456789"
                },
                "is_active": true,
                "is_id_verified": true,
                "issuing_app_id": "842352f4-8a6f-4a19-89c6-4e8a240a2355",
                "last_name": "Doe",
                "phone": "2348135471627"
            }
        ],
        "meta": {
            "total": 2,
            "pages": 1,
            "previous": null,
            "next": null
        }
    }
}

Get all issued cards

This endpoint returns a list of all the cards that you have issued on your account

curl --location --request GET 'https://issuecards.api.bridgecard.co/v1/issuing/sandbox/cards/get_all_cards?page=1' \
--header 'token: Bearer *****' \
--data-raw ''
Response

🟢 200: All issued cards have been fetched successfully

{
    "status": "success",
    "message": "All your issued cards have been fetched successfully",
    "data": {
        "cards": [
            {
                "billing_address": {
                    "billing_address1": "256 Chapman Road STE 105-4",
                    "billing_city": "Newark",
                    "billing_country": "US",
                    "billing_zip_code": "19702",
                    "country_code": "US"
                },
                "brand": "Mastercard",
                "card_currency": "USD",
                "card_id": "70b34986c13c4026a999999e27eabc49",
                "card_name": "John Doe",
                "card_number": "ev:RFVC:/k2ywhfd6puozkZx:A23n3EoM5dZwHG24zaS+meBBIbgJ03OCfO6GnFSPl5tS:1BLgOZHre56P9DPkhqHJJaifHnlvzGzQ5sSrn+xWcT8:$",
                "card_type": "virtual",
                "cardholder_id": "d0658fedf82866d9699999083fa",
                "created_at": 1659826136,
                "cvv": "ev:RFVC:5ek3QdaiLFvaL4md:A23n3EoM5dZwHG24zaS+meBBIbgJ03OCfO6GnFSPl5tS:aI3XxL+A54ZITT9/zPjV11J0yA:$",
                "expiry_month": "ev:RFVC:gDwn8Kqsg9rmVSeK:A23n3EoM5dZwHG24zaS+meBBIbgJ03OCfO6GnFSPl5tS:QpMwLxi1g+uVpB88+XKtg6Dp:$",
                "expiry_year": "ev:RFVC:bOzx6EkH6brriobW:A23n3EoM5dZwHG24zaS+meBBIbgJ03OCfO6GnFSPl5tS:mKtDnYDJ9pdoa2Pz01gl4qEDLB4:$",
                "is_active": true,
                "issuing_app_id": "842352f4-8a6f-4a19-89c6-999940a2355",
                "last_4": "8623",
                "livemode": false,
                "meta_data": null
            },
            {
                "billing_address": {
                    "billing_address1": "256 Chapman Road STE 105-4",
                    "billing_city": "Newark",
                    "billing_country": "US",
                    "billing_zip_code": "19702",
                    "country_code": "US"
                },
                "brand": "Mastercard",
                "card_currency": "USD",
                "card_id": "581b044df66a4a428bc9999915655e8e",
                "card_name": "John Doe",
                "card_number": "ev:RFVC:Gh4YvEoa8/Ua8gtC:AyY2y7CaFrWCiWB7GZKI4+w/b4kLhyQaP4r0/hsVSOB/:dGwEilDdCqrdBKjFyKzkBToxefEpCguuF+rRfFsJfCo:$",
                "card_type": "virtual",
                "cardholder_id": "d0658fedf82842079999961e4a7083fa",
                "created_at": 1659746672,
                "cvv": "ev:RFVC:3AlzAf1BTFg2SYYG:AyY2y7CaFrWCiWB7GZKI4+w/b4kLhyQaP4r0/hsVSOB/:9O7on5JfbNcyhpo2Ggp97+A8wQ:$",
                "expiry_month": "ev:RFVC:8m9dVKhiQNVbmJtL:AyY2y7CaFrWCiWB7GZKI4+w/b4kLhyQaP4r0/hsVSOB/:ieCzK8W29dimD8k8aPCC4ama:$",
                "expiry_year": "ev:RFVC:i1L76Uhr2nicnoRV:AyY2y7CaFrWCiWB7GZKI4+w/b4kLhyQaP4r0/hsVSOB/:39Qlfqi7eQWiqFqMTqfZ8mgzj40:$",
                "is_active": true,
                "issuing_app_id": "842352f4-8a6f-4a19-89c6-440a2355",
                "last_4": "8615",
                "livemode": false,
                "meta_data": {
                    "user_id": "d0658fedf8284207866d96083fa"
                }
            }
        ],
        "meta": {
            "total": 2,
            "pages": 1,
            "previous": null,
            "next": null
        }
    }
}

Fund issuing wallet

SANDBOX

You can use this endpoint to credit your issuing wallet with some fake money in the sandbox environment.

curl --location --request PATCH 'https://issuecards.api.bridgecard.co/v1/issuing/sandbox/cards/fund_issuing_wallet' \
--header 'token: Bearer *****' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": "0"
}'
Body

Response

🟢 200: card was funded successfully.

{
    "status": "success",
    "message": "Your issuing wallet was funded successfully",
    "data": {}
}

PRODUCTION

To begin the process of funding your account in production:

  1. Login to your dashboard.

  2. Click the + icon on your production wallet on your dashboard to begin the transfer process.

Note: We now support funding your production account automatically in USDT, XAF and UGX.

Get issuing wallet balance

You can use this wallet to fetch the current balance on your issuing wallet.

curl --location --request GET 'https://issuecards.api.bridgecard.co/v1/issuing/sandbox/cards/get_issuing_wallet_balance' \
--header 'token: Bearer *****' \
--data-raw ''
Response

🟢 200: Issuing wallet balance has been fetched successfully

{
  "status": "success",
  "message": "Your issuing wallet balance has been fetched successfully",
  "data": {
    "issuing_balance_USD": "23750"
  }
}

Get FX rate

This endpoint provides you with the rates at which we perform trades from local currencies to the USD

curl --location --request GET 'https://issuecards.api.bridgecard.co/v1/issuing/cards/fx-rate' \
--header 'accept: application/json' \
--header 'token: Bearer xxxxx'
Response

🟢 200 : states fetched successfully

{
    "status": "success",
    "message": "Rate fetched successfully",
    "data": {
        "NGN-USD": 74100
    }
}

Get all states

This endpoint provides you with a list of states under a country.

curl --location --request GET 'https://issuecards.api.bridgecard.co/v1/issuing/sandbox/cardholder/get_all_states?country=Nigeria' \
--header 'accept: application/json' \
--header 'token: Bearer at_live_****'
Response

🟢 201 : states fetched successfully

{
  "status": "success",
  "message": "States fetched successfully",
  "data": {
    "states": [
      "Abuja",
      "Abia",
      "Adamawa",
      "Akwa Ibom",
      "Anambra",
      "Bauchi",
      "Bayelsa",
      "Benue",
      "Borno",
      "Cross River",
      "Delta",
      "Ebonyi",
      "Edo",
      "Ekiti",
      "Enugu",
      "Gombe",
      "Imo",
      "Jigawa",
      "Kaduna",
      "Kano",
      "Katsina",
      "Kebbi",
      "Kogi",
      "Kwara",
      "Lagos",
      "Nasarawa",
      "Niger",
      "Ogun",
      "Ondo",
      "Osun",
      "Oyo",
      "Plateau",
      "Rivers",
      "Sokoto",
      "Taraba",
      "Yobe",
      "Zamfara"
    ]
  }
}

Last updated