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

# Get a gift card order



## OpenAPI

````yaml /api-reference/openapi.json get /gift-card-orders/{id}
openapi: 3.1.0
info:
  title: Churning Tracker API
  version: 1.0.0
  description: Read and write your buying group orders, gift card orders, and shipments.
servers:
  - url: https://app.churningtracker.com/api/v1
security:
  - apiKey: []
    apiSecret: []
tags:
  - name: Buying group orders
  - name: Gift card orders
  - name: Shipments
  - name: Credit cards
paths:
  /gift-card-orders/{id}:
    get:
      tags:
        - Gift card orders
      summary: Get a gift card order
      operationId: get-gift-card-orders
      parameters:
        - name: id
          in: path
          required: true
          description: Order ID.
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: The order.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/GiftCardOrder'
              example:
                data:
                  id: 0b6f3c1e-8f4a-4c2e-9d55-2f1a7e3b9c10
                  source: api
                  orderDate: '2026-10-01'
                  orderTime: null
                  retailer: Staples
                  orderNumber: STP-8812345
                  retailerAccount: null
                  subtotal: 101190
                  shipping: 0
                  tax: 0
                  discount: 0
                  total: 101190
                  creditCardId: null
                  subCreditCardId: null
                  cardEarnRate: 0
                  notes: null
                  cashback: null
                  createdAt: '2026-10-01T18:30:00.000Z'
                  status: purchased
                  expectedPayout: 100000
                  orderLineItems:
                    - id: c2d0a8f4-1b7e-4f0a-8a3e-5b6c7d8e9f01
                      description: Visa gift card
                      model: null
                      unitPrice: 50595
                      quantity: 2
                      expectedUnitPayout: 50000
                      unitValue: 50000
                  platform: card_cash
        '401':
          description: Missing or invalid credentials.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Your plan doesn't include API access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Order not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limited.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    GiftCardOrder:
      type: object
      properties:
        id:
          type: string
          format: uuid
        source:
          type: string
          enum:
            - dashboard
            - extension
            - csv_import
            - api
            - email_automation
          description: How the order was created.
        orderDate:
          type: string
          format: date
        orderTime:
          type:
            - string
            - 'null'
          example: '14:30:00'
        retailer:
          type: string
        orderNumber:
          type:
            - string
            - 'null'
        retailerAccount:
          type:
            - string
            - 'null'
        subtotal:
          type: integer
          minimum: 0
          description: Sum of line items in cents.
        shipping:
          type: integer
          minimum: 0
          description: Shipping in cents.
        tax:
          type: integer
          minimum: 0
          description: Tax in cents.
        discount:
          type: integer
          minimum: 0
          description: Discount in cents.
        total:
          type: integer
          minimum: 0
          description: Subtotal plus shipping and tax, minus discount in cents.
        creditCardId:
          type:
            - string
            - 'null'
        subCreditCardId:
          type:
            - string
            - 'null'
        cardEarnRate:
          type: number
          description: >-
            Points or cashback multiplier, e.g. `2` for 2x or `1.5` for 1.5x. Up
            to three decimal places.
        notes:
          type:
            - string
            - 'null'
        cashback:
          oneOf:
            - $ref: '#/components/schemas/Cashback'
            - type: 'null'
          description: Cashback stacked on the order, e.g. from a shopping portal.
        createdAt:
          type: string
          format: date-time
        expectedPayout:
          type: integer
          minimum: 0
          description: Sum of the line items' expected payouts in cents.
        platform:
          type: string
          maxLength: 100
          description: >-
            Resale platform: `aligned_incentives`, `card_center`, `card_cash`,
            `qgcg`, or one of your custom platforms.
          example: card_cash
        status:
          type: string
          enum:
            - purchased
            - submitted
            - partially_paid
            - issue
            - paid
            - cancelled
          example: purchased
        orderLineItems:
          type: array
          items:
            $ref: '#/components/schemas/GiftCardLineItem'
      required:
        - id
        - source
        - orderDate
        - orderTime
        - retailer
        - orderNumber
        - retailerAccount
        - subtotal
        - shipping
        - tax
        - discount
        - total
        - creditCardId
        - subCreditCardId
        - cardEarnRate
        - notes
        - cashback
        - createdAt
        - expectedPayout
        - platform
        - status
        - orderLineItems
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              example: invalid_request
            message:
              type: string
            issues:
              type: array
              description: Per-field problems, when there are any.
              items:
                type: object
                properties:
                  path:
                    type: string
                    example: orderLineItems.0.unitPrice
                  message:
                    type: string
    Cashback:
      type: object
      properties:
        platform:
          type: string
        status:
          type: string
        rewardType:
          type: string
          enum:
            - cashback
            - points_miles
        rewardAmount:
          type:
            - number
            - 'null'
          description: >-
            Cents for `cashback`, or points or miles for `points_miles`. Null
            until entered.
    GiftCardLineItem:
      type: object
      properties:
        id:
          type: string
        description:
          type:
            - string
            - 'null'
        model:
          type:
            - string
            - 'null'
        unitPrice:
          type: integer
          minimum: 0
          description: Price per unit in cents.
        quantity:
          type: integer
        expectedUnitPayout:
          type: integer
          minimum: 0
          description: Expected payout per unit in cents.
        unitValue:
          type: integer
          minimum: 0
          description: Face value of each card in cents.
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: Your API key, starting with `ct_key_`.
    apiSecret:
      type: apiKey
      in: header
      name: x-api-secret
      description: Your API secret, starting with `ct_secret_`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.