Get Card Offers

The getVirtualCardOffers query allows you to retrieve a list of active virtual card offers — each offer is a card program you can issue against.

Prerequisites: a user access token with the CREATE_VIRTUALCARD scope.

Arguments

input (GetVirtualCardOffersInput): Optional input to filter the virtual card offers.

GetVirtualCardOffersInput fields

Field	Type	Description	Required
`cardBrandLocked`	`Boolean`	Specify if virtual card offers are brand locked.	No
`cardType`	`VirtualCardOfferType`	Specify virtual card network type (`DEBIT` or `PREPAID`).	No
`cardNetwork`	`VirtualCardNetwork`	Specify virtual card network type (`MASTERCARD` or `VISA`).	No

Sample query

query GetVirtualCardOffers {
    getVirtualCardOffers {
        offerId
        bin
        bankName
        rewardValue
        programLimits {
            dailyLimit
            weeklyLimit
            monthlyLimit
        }
        programName
    }
}

cURL example

curl -X POST \
  https://transactional-graph.staging.fluzapp.com/api/v1/graphql \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_USER_ACCESS_TOKEN' \
  -d '{
    "query": "query { getVirtualCardOffers(input: { cardType: DEBIT, cardNetwork: MASTERCARD }) { offerId programName bin bankName programLimits { dailyLimit weeklyLimit monthlyLimit } rewardValue } }"
  }'

Sample response

Offers are sorted by rewardValue.

{
  "data": {
    "getVirtualCardOffers": [
      {
        "offerId": "offer-id-1",
        "programName": "Example Card Program A",
        "bin": "543210",
        "bankName": "Bank of Examples",
        "programLimits": {
          "dailyLimit": "500.00",
          "weeklyLimit": "2000.00",
          "monthlyLimit": "5000.00"
        },
        "rewardValue": "1.5%"
      },
      {
        "offerId": "offer-id-2",
        "programName": "Example Card Program B",
        "bin": "456789",
        "bankName": "Another Bank",
        "programLimits": {
          "dailyLimit": "1000.00",
          "weeklyLimit": "4000.00",
          "monthlyLimit": "10000.00"
        },
        "rewardValue": "1%"
      }
    ]
  }
}

Response fields

Field	Type	Description
`offerId`	`String`	The unique identifier for the virtual card offer.
`programName`	`String`	The name of the virtual card program or merchant.
`bin`	`String`	The Bank Identification Number (BIN) associated with the virtual card offer.
`bankName`	`String`	The name of the issuing bank for this virtual card offer.
`programLimits`	`ProgramLimits`	An object detailing the spending limits for this program.
`programLimits.dailyLimit`	`String`	The maximum amount that can be spent daily on cards from this program.
`programLimits.weeklyLimit`	`String`	The maximum amount that can be spent weekly on cards from this program.
`programLimits.monthlyLimit`	`String`	The maximum amount that can be spent monthly on cards from this program.
`rewardValue`	`String`	The earn rate or reward percentage offered by this virtual card program.

Next steps

Create a virtual card

Pass the offerId you picked into createVirtualCard.

Card linked offers

Merchant-specific offers that layer additional rewards on top of the base program.

​Arguments

​GetVirtualCardOffersInput fields

​Sample query

​cURL example

​Sample response

​Response fields

​Next steps

Create a virtual card

Card linked offers

Arguments

GetVirtualCardOffersInput fields

Sample query

cURL example

Sample response

Response fields

Next steps