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

# GET /GiftCards/{cardNumber}

> Retrieve a single gift card by its card number.

Retrieve a single gift card by its card number.

<ParamField header="X-API-KEY" type="string" required>Your API key</ParamField>

<ParamField path="cardNumber" type="string" required>Gift card number. Format: `XXXXX-XXXXXXXX-XXXX`</ParamField>

<CodeGroup>
  ```shell curl theme={null}
  curl --location '[BASE_URL]/GiftCards/ABCDE-12345678-WXYZ' \
  --header 'X-API-KEY: your_api_key_here'
  ```
</CodeGroup>

Returns a single GiftCard object. See `GET /GiftCards` for full field descriptions.

**Example 200 Response**

```json theme={null}
{
  "cardNumber": "ABCDE-12345678-WXYZ",
  "issuedDate": "2024-01-10T09:00:00Z",
  "expiryDate": "2025-01-10T09:00:00Z",
  "amount": 100.00,
  "remainingAmount": 75.00,
  "status": "Active",
  "paymentType": "Online",
  "cardFormat": "EGiftCard",
  "purchaserFirstName": "John",
  "purchaserLastName": "Doe",
  "purchaserEmail": "john.doe@example.com",
  "recipientFirstName": "Jane",
  "recipientLastName": "Doe",
  "recipientEmail": "jane.doe@example.com"
}
```

| Status | Description                                       |
| ------ | ------------------------------------------------- |
| `200`  | Gift card returned                                |
| `400`  | API key not associated with a venue               |
| `400`  | `No Venue Subscribed to your App.`                |
| `401`  | X-API-KEY missing or invalid                      |
| `404`  | `cardNumber` — Card not found for this venue      |
| `404`  | `gift card '{cardNumber}' not found.`             |
| `500`  | `Failed to retrieve card '{cardNumber}' details.` |


## OpenAPI

````yaml GET /GiftCards/{cardNumber}
openapi: 3.0.4
info:
  title: NowBookIt IPOS Partner API
  description: >-
    REST API for integrating your POS or external system with NowBookIt's
    reservation, sales, and gift card platform.
  version: v1
  contact:
    email: platform.integrations@nowbookit.com
servers:
  - url: https://ipos.dev.nowbookit.com
    description: Development
  - url: https://ipos.nowbookit.com
    description: Production
security:
  - ApiKeyAuth: []
paths:
  /GiftCards/{cardNumber}:
    get:
      tags:
        - GiftCards
      summary: Get Gift Card
      operationId: getGiftCard
      parameters:
        - name: cardNumber
          in: path
          required: true
          schema:
            type: string
        - name: X-API-KEY
          in: header
          description: API Key authentication header
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GiftCard'
        '500':
          description: Internal Server Error
      security:
        - ApiKeyAuth: []
components:
  schemas:
    GiftCard:
      type: object
      properties:
        issuedDate:
          type: string
          format: date-time
        cardNumber:
          type: string
          description: 'The Card Number printed on the GiftCard. Format: XXXXX-XXXXXXXX-XXXX'
          nullable: true
        expiryDate:
          type: string
          format: date-time
        amount:
          type: number
          description: The Total Card balance (in decimal).
          format: double
        remainingAmount:
          type: number
          description: After Partial redeem(s) the remaining Card Balance (in decimal).
          format: double
        status:
          type: string
          description: >-
            Options: Active, Cancelled, Redeemed, AwaitingPayment,
            PendingPostage, Expired
          nullable: true
        paymentType:
          type: string
          description: 'Options: InHouse, Online, Complimentary'
          nullable: true
        cardFormat:
          type: string
          description: >-
            Options: EGiftCard, PhysicalCard, ExperienceGiftCard, LSEGiftCard,
            LSExperienceGiftCard
          nullable: true
        experienceCardName:
          type: string
          nullable: true
        experienceCardDetails:
          type: string
          nullable: true
        purchaserFirstName:
          type: string
          nullable: true
        purchaserLastName:
          type: string
          nullable: true
        purchaserEmail:
          type: string
          nullable: true
        recipientFirstName:
          type: string
          nullable: true
        recipientLastName:
          type: string
          nullable: true
        recipientEmail:
          type: string
          nullable: true
      additionalProperties: false
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY

````