> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<Info>
  **Prerequisites:** a user access token with the `CREATE_VIRTUALCARD` scope.
</Info>

## 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

```graphql theme={null}
query GetVirtualCardOffers {
    getVirtualCardOffers {
        offerId
        bin
        bankName
        rewardValue
        programLimits {
            dailyLimit
            weeklyLimit
            monthlyLimit
        }
        programName
    }
}
```

## cURL example

```curl theme={null}
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.

```json theme={null}
{
  "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

<CardGroup cols={2}>
  <Card title="Create a virtual card" icon="credit-card" href="/features/create-card">
    Pass the `offerId` you picked into `createVirtualCard`.
  </Card>

  <Card title="Card linked offers" icon="badge-percent" href="/features/card-linked-offers">
    Merchant-specific offers that layer additional rewards on top of the base program.
  </Card>
</CardGroup>