> ## 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.

# Get Loyalty Program Customers

> ### List Loyalty Program Customers

Retrieves a list of customers associated with a specific loyalty program.

**Path Parameters**:
- `programId`: UUID of the loyalty program

**Query Parameters**:
- `phone`: Filter by customer's phone number (optional)
- `email`: Filter by customer's email (optional)
- `pid`: Filter by personal identifier (optional)
- `pidNumber`: Filter by personal identifier number (optional)
- `includeTotal`: Include total member count in response (default: false)

**Returns**:
- By default: A list of customer details as JSON objects.
- If includeTotal=true: An object with `customers` array and `total` count.



## OpenAPI

````yaml https://api.loyalty.dog/openapi.json get /v2/loyalty/programs/{programId}/customers
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/loyalty/programs/{programId}/customers:
    get:
      tags:
        - Loyalty
      summary: Get Loyalty Program Customers
      description: >-
        ### List Loyalty Program Customers


        Retrieves a list of customers associated with a specific loyalty
        program.


        **Path Parameters**:

        - `programId`: UUID of the loyalty program


        **Query Parameters**:

        - `phone`: Filter by customer's phone number (optional)

        - `email`: Filter by customer's email (optional)

        - `pid`: Filter by personal identifier (optional)

        - `pidNumber`: Filter by personal identifier number (optional)

        - `includeTotal`: Include total member count in response (default:
        false)


        **Returns**:

        - By default: A list of customer details as JSON objects.

        - If includeTotal=true: An object with `customers` array and `total`
        count.
      operationId: >-
        get_loyalty_program_customers_v2_loyalty_programs__programId__customers_get
      parameters:
        - name: programId
          in: path
          required: true
          schema:
            anyOf:
              - $ref: '#/components/schemas/PydanticObjectId'
              - type: string
            title: Programid
        - name: phone
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Phone
        - name: email
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Email
        - name: pid
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Pid
        - name: pidNumber
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Pidnumber
        - name: orderBy
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Orderby
        - name: byName
          in: query
          required: false
          schema:
            anyOf:
              - type: boolean
              - type: 'null'
            title: Byname
        - 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: authorization
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '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
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    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.

````