> ## 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 Bulk Order Status

Use the `getVirtualCardBulkOrderStatus` query to check the status of a bulk virtual card creation order and retrieve the details of the created cards as the order is processed.

<Info>
  **Prerequisites:** a user access token with the `CREATE_VIRTUALCARD` scope, and the `orderId` returned by [Create Bulk Order](/features/create-bulk-order).
</Info>

<Warning>
  The response includes full card numbers, CVVs, and expiry dates in plaintext. Handle it as sensitive cardholder data — transmit over TLS, never log it, and surface it only to authorized users.
</Warning>

## Arguments

* `input` (`GetVirtualCardBulkOrderStatusInput!`): The input object containing the identifier for the bulk order.

## GetVirtualCardBulkOrderStatusInput fields

| Field     | Type      | Description                                                                                                 | Required |
| :-------- | :-------- | :---------------------------------------------------------------------------------------------------------- | :------- |
| `orderId` | `String!` | The unique identifier for the bulk order, which you receive from the `createVirtualCardBulkOrder` mutation. | Yes      |

## cURL example

```bash 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 GetVirtualCardBulkOrderStatus { getVirtualCardBulkOrderStatus( input: { orderId: \"ZTBhYTg2YmQtZWQwYS00OWQxLTk5ZmUtZDBhZGY3ZjYxZGUyfDI0NjMyM2NmLTBkMzEtNGI2YS04NGQ2LTRmNGI2NzMzNmU5Yw==\" } ) { orderStatus orderId virtualCards { cardNumber expiryMMYY cvv cardHolderName virtualCardId billingAddress { city } } successfulCardCreations failedCardCreations totalCards } }"
  }'
```

## Sample query

```graphql theme={null}
query GetVirtualCardBulkOrderStatus {
    getVirtualCardBulkOrderStatus(
        input: {
            orderId: "<<ORDER_ID>>"
        }
    ) {
        orderStatus
        orderId
        virtualCards {
            cardNumber
            expiryMMYY
            cvv
            cardHolderName
            virtualCardId
            billingAddress {
                city
            }
        }
        successfulCardCreations
        failedCardCreations
        totalCards
    }
}
```

## Sample response

```json theme={null}
{
    "data": {
        "getVirtualCardBulkOrderStatus": {
            "orderStatus": "COMPLETED",
            "orderId": "<<ORDER_ID>>",
            "virtualCards": [
                {
                    "cardNumber": "5111147189413564",
                    "expiryMMYY": "08/29",
                    "cvv": "143",
                    "cardHolderName": "Test",
                    "virtualCardId": "104b50d2-97e5-49ee-b9fd-b42120d68212",
                    "billingAddress": {
                        "city": "San Jose"
                    }
                },
                {
                    "cardNumber": "5111143166431356",
                    "expiryMMYY": "08/29",
                    "cvv": "135",
                    "cardHolderName": "Test",
                    "virtualCardId": "03291f04-8358-44f7-ac58-73a6643ac07f",
                    "billingAddress": {
                        "city": "San Jose"
                    }
                }
            ],
            "successfulCardCreations": 4,
            "failedCardCreations": 0,
            "totalCards": 4
        }
    }
}
```

## Response fields

| Field                           | Type                          | Description                                                                      |
| ------------------------------- | ----------------------------- | -------------------------------------------------------------------------------- |
| `orderId`                       | `String`                      | The unique identifier for the bulk creation order.                               |
| `orderStatus`                   | `VirtualCardBulkOrderStatus!` | The status of the bulk order (e.g., `COMPLETED`, `PENDING`, `FAILED`).           |
| `virtualCards`                  | `[VirtualCardDetails]`        | Full details for each successfully created card. Populated as cards are created. |
| `virtualCards[].cardNumber`     | `String`                      | The full 16-digit virtual card number.                                           |
| `virtualCards[].expiryMMYY`     | `String`                      | The expiration date of the card in MM/YY format.                                 |
| `virtualCards[].cvv`            | `String`                      | The 3-digit security code for the card.                                          |
| `virtualCards[].cardHolderName` | `String`                      | The name assigned to the cardholder.                                             |
| `virtualCards[].virtualCardId`  | `UUID`                        | The unique identifier for the virtual card.                                      |
| `virtualCards[].billingAddress` | `Object`                      | The billing address associated with the virtual card.                            |
| `successfulCardCreations`       | `Int`                         | The number of cards successfully created so far.                                 |
| `failedCardCreations`           | `Int`                         | The number of cards that failed to be created.                                   |
| `totalCards`                    | `Int`                         | The total number of cards requested in the order.                                |

<Tip>
  Poll this query until `orderStatus` is `COMPLETED` (or `FAILED`). While `PENDING`, `virtualCards` fills in incrementally and `successfulCardCreations` climbs toward `totalCards`.
</Tip>

## Next steps

<CardGroup cols={2}>
  <Card title="Reveal a virtual card" icon="eye" href="/recipes/reveal-virtual-card">
    Retrieve sensitive card details securely for a single card.
  </Card>

  <Card title="Virtual card error codes" icon="triangle-alert" href="/features/virtual-card-error-codes">
    Interpret `failedCardCreations` and handle partial-failure cases.
  </Card>
</CardGroup>