---
title: "Get VCC payout details for a reservation"
method: GET
path: "/connectivity-payments/reservations/{reservation-id}/payout/vcc"
tags: ["VCC payout details, per accommodation reservation"]
---

# Get VCC payout details for a reservation

`GET /connectivity-payments/reservations/{reservation-id}/payout/vcc`

## Request

- Base URL: `https://payments-api.booking.com`
- URL: `https://payments-api.booking.com/connectivity-payments/reservations/{reservation-id}/payout/vcc`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/booking/apis/payments-api/docs/connectivity-payments/reservations/:reservation-id/payout/vcc/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve information on the virtual credit cards associated with a reservation and changes to the VCC payout.

## Path parameters

- `reservation-id` string, required

## Query parameters

- `vcc-id` string

## Headers

- `accept-version` '1.0' | '1.1' | '1.2'
- `Authorization` string, required

## Response `200`

Successfully retrieved information about the VCCs associated with respective accommodation reservation

- VCCPayoutResponse: Response containing VCC payout information for a reservation
  - `meta` DefaultMeta: Metadata for the response
    - `ruid` string: Request unique identifier
  - `data` VCCPayoutData: VCC payout information for a reservation
    - `reservation_id` string: Accommodation reservation identifier
    - `property_id` string: Property identifier
    - `payout_type` string: Type of payout: GROSS, NET, or UNKNOWN.
    - `payout` object: Payout instruments
      - `virtual_credit_cards` PayoutVCC[]: Virtual credit card payouts
        - `activation_date` string, date: Date the VCC becomes active
        - `id` string, required: VCC identifier
        - `current_balance` AmountVCCBalance, required: Contains information on the current balance of the VCC.
          - `currency` string: Currency of the amount.
          - `value` string: Current balance of the VCC.
          - `decimals` integer: Number of decimals in the amount.
        - `expiration_date` string, date: Date the VCC expires
        - `status` string, required: Possible VCC status values: NOT_LOADED, FUNDED, AVAILABLE, PARTIALLY_CHARGED, FULLY_CHARGED, CANCELLED, or UNKNOWN.
        - `card_details` VCCCardDetails, required: Card details for a virtual credit card
          - `cvc` string, required: Card verification code
          - `card_name` string, required: Name on the card
          - `card_number` string, required: Card number
          - `card_expiry` string, required: Card expiry date (MM/YY)
          - `card_type` string: Card scheme, for example VISA. Available from version 1.2.
  - `errors` unknown[]
    - unknown
  - `warnings` unknown[]
    - unknown

## Other responses

- `400`: Invalid request payload.
- `401`: Unauthorized. Missing or invalid authentication token.
- `403`: Access Denied!
- `404`: The reservation data is not found at this moment.
- `410`: Reservation cannot be processed because the checkout date is older than the allowed 18-months window.
- `429`: You exceeded the rate limit.
- `500`: The request failed with an internal server error.

## Changes

- **2026-11-11** `98d75d700655`: 3 breaking, 4 info
  - the `accept-version` request header's property undefined was restricted to a list of enum values
  - the `header` request parameter `accept-version` was restricted to a list of enum values
  - for the `header` request parameter `accept-version`, default value `1.2` was added
  - added the new enum value `1.0` to the `header` request parameter `accept-version`
  - …3 more
- **2026-10-06** `85e0252f4e64`: 1 warning, 1 info
  - removed the optional property `data/allOf[#/components/schemas/VCCPayoutData]/payout/virtual_credit_cards/items/card_details/card_type` from the response with the `200` status
  - for the `path` request parameter `reservation-id`, the type was generalized from `integer` to `string`

[Operation history](https://skmtc.dev/booking/apis/payments-api/changes/connectivity-payments/reservations/:reservation-id/payout/vcc/get.md)

---

[API](https://skmtc.dev/booking/apis/payments-api.md) - [All operations](https://skmtc.dev/booking/apis/payments-api/llms.txt) - [OpenAPI document](https://skmtc.dev/booking/apis/payments-api/revisions/98d75d700655?raw)