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.

Prerequisites: a user access token with the CREATE_VIRTUALCARD scope, and the orderId returned by Create Bulk Order.

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.

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

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

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

Sample response

{
    "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.

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

Next steps

Reveal a virtual card

Retrieve sensitive card details securely for a single card.

Virtual card error codes

Interpret failedCardCreations and handle partial-failure cases.

​Arguments

​GetVirtualCardBulkOrderStatusInput fields

​cURL example

​Sample query

​Sample response

​Response fields

​Next steps

Reveal a virtual card

Virtual card error codes

Arguments

GetVirtualCardBulkOrderStatusInput fields

cURL example

Sample query

Sample response

Response fields

Next steps