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

# Getcustomertransactions

> ### Get All Customer Transactions

Returns paginated transaction history across all gift cards belonging to the customer.



## OpenAPI

````yaml https://api.loyalty.dog/openapi.json get /v2/giftcards/customer/transactions
openapi: 3.1.0
info:
  title: LoyaltyDog
  description: >-

    Welcome to the LoyaltyDog API! This API provides access to our loyalty
    program features, allowing you to integrate with various platforms and
    manage your loyalty data.


    Want to query LoyaltyDog via an AI assistant (Claude, Cursor, Windsurf)? See
    the [MCP Integration guide](https://loyaltydog.ai/playground#mcp).
        
  termsOfService: https://loyalty.dog/loyalty-program-terms-service
  contact:
    name: LoyaltyDog Support
    url: https://loyalty.dog/contact-us
    email: support@loyalty.dog
  version: 1.0.1
servers:
  - url: https://api.loyalty.dog
    description: Production
security:
  - bearerAuth: []
paths:
  /v2/giftcards/customer/transactions:
    get:
      tags:
        - Gift Cards
      summary: Getcustomertransactions
      description: >-
        ### Get All Customer Transactions


        Returns paginated transaction history across all gift cards belonging to
        the customer.
      operationId: getCustomerTransactions_v2_giftcards_customer_transactions_get
      parameters:
        - name: programId
          in: query
          required: false
          schema:
            anyOf:
              - $ref: '#/components/schemas/PydanticObjectId'
              - type: 'null'
            title: Programid
        - name: cardId
          in: query
          required: false
          schema:
            anyOf:
              - $ref: '#/components/schemas/PydanticObjectId'
              - type: 'null'
            title: Cardid
        - name: q
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Q
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
            title: Page
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 250
            title: Limit
        - name: offset
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            title: Offset
        - name: X-Eposn-Customer-Token
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Eposn-Customer-Token
        - name: X-Eposn-Merchant-Token
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Eposn-Merchant-Token
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TransactionResponse'
                title: >-
                  Response Getcustomertransactions V2 Giftcards Customer
                  Transactions Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    PydanticObjectId:
      type: string
      maxLength: 24
      minLength: 24
      pattern: ^[0-9a-f]{24}$
      example: 5eb7cf5a86d9755df3a6c593
    TransactionResponse:
      properties:
        id:
          $ref: '#/components/schemas/PydanticObjectId'
        transactionType:
          $ref: '#/components/schemas/GiftCardTransactionType'
        amount:
          type: string
          title: Amount
        balanceBefore:
          type: string
          title: Balancebefore
        balanceAfter:
          type: string
          title: Balanceafter
        referenceId:
          anyOf:
            - type: string
            - type: 'null'
          title: Referenceid
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
        createdAt:
          type: string
          format: date-time
          title: Createdat
        processedAt:
          type: string
          format: date-time
          title: Processedat
        merchantId:
          $ref: '#/components/schemas/PydanticObjectId'
        posTransactionId:
          anyOf:
            - type: string
            - type: 'null'
          title: Postransactionid
        cashierId:
          anyOf:
            - type: string
            - type: 'null'
          title: Cashierid
        terminalId:
          anyOf:
            - type: string
            - type: 'null'
          title: Terminalid
      type: object
      required:
        - id
        - transactionType
        - amount
        - balanceBefore
        - balanceAfter
        - referenceId
        - description
        - createdAt
        - processedAt
        - merchantId
        - posTransactionId
        - cashierId
        - terminalId
      title: TransactionResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    GiftCardTransactionType:
      type: string
      enum:
        - PURCHASE
        - ACTIVATION
        - RELOAD
        - REDEMPTION
        - CONSOLIDATION
        - VOID
        - TRANSFER_OUT
        - TRANSFER_IN
        - OWNERSHIP_TRANSFER
        - RESEND_CODE
        - REFUND
      title: GiftCardTransactionType
      description: Gift card transaction type enumeration.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT access token obtained from POST /v2/token.

````