## Get List of Players Participating in Campaign

This endpoint retrieves a list of players in a campaign.

**API Call Sample:**

**Query Parameters:**

```json
{
  "$ref": "#/components/schemas/ParticipantFilterDto",
  "components": {
    "schemas": {
      "PagingInfo": {
        "type": "object",
        "properties": {
          "pageNumber": {
            "type": "integer",
            "format": "int32",
            "default": 1,
            "description": "Page number",
            "example": 1
          },
          "pageSize": {
            "type": "integer",
            "format": "int32",
            "default": 50,
            "description": "Page size",
            "example": 10
          },
          "sortBy": {
            "type": "string",
            "default": "id",
            "description": "Field to sort by",
            "example": "id"
          },
          "order": {
            "type": "string",
            "default": "ASCENDING",
            "description": "Sort order. Parameter for pagination. Possible values: ASCENDING, DESCENDING",
            "example": "ASCENDING"
          }
        }
      },
      "ParticipantFilterDto": {
        "properties": {
          "playerId": {
            "type": "string",
            "description": "Player identifier in the Operator side",
            "example": "player1"
          },
          "receivedAt": {
            "type": "string",
            "format": "date",
            "description": "Date of receiving free rounds",
            "example": "2022-01-02"
          },
          "lastRoundDate": {
            "type": "string",
            "format": "date",
            "description": "Date of the last played free round within the campaign",
            "example": "2022-01-02"
          },
          "status": {
            "type": "string",
            "description": "* QUEUED - A bonus is awarded to a player who has not used any of the free rounds yet.\n\n* IN_USE - A bonus is awarded to a player who has accepted the campaign. This status also applies to players who have started but haven't completed the free rounds yet. Free rounds for those players remain available even after the expiry date of the campaign.\n\n* COMPLETED - The player consumed all available free rounds, and any winnings have been awarded (issued to the Operator).\n\n* EXPIRED - The expiry date for free rounds has been reached, the promotion has been removed from player accounts, and any players who have not participated yet are not able to complete the promotion.\n\n* OPT_OUT - Player has declined the promotion pop up",
            "example": "QUEUED"
          },
          "paging": {
            "$ref": "#/components/schemas/PagingInfo"
          }
        }
      }
    }
  }
}
```

**Response Schema:**

```json
{
  "$ref": "#/components/schemas/SearchResultParticipantDtoLong",
  "components": {
    "schemas": {
      "ParticipantDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64",
            "description": "Player ID in RubyPlay system.",
            "example": 7
          },
          "playerId": {
            "type": "string",
            "description": "Player ID in Operatorʼs system.",
            "example": "player123"
          },
          "receivedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date and time of receiving free rounds.",
            "example": "2022-02-22T22:22:22Z"
          },
          "totalBet": {
            "type": "integer",
            "format": "int64",
            "description": "Total bet amount of played free rounds.",
            "example": 777
          },
          "totalWin": {
            "type": "integer",
            "format": "int64",
            "description": "Total win of free rounds.",
            "example": 77
          },
          "roundsPlayed": {
            "type": "integer",
            "format": "int32",
            "description": "The number of played free rounds.",
            "example": 7
          },
          "lastRoundDate": {
            "type": "string",
            "format": "date-time",
            "description": "Date and time of the last played free round.",
            "example": "2022-02-22T22:22:22Z"
          },
          "status": {
            "type": "string",
            "description": "* QUEUED - A bonus is awarded to a player who has not used any of the free rounds yet.\n\n* IN_USE - A bonus is awarded to a player who has accepted the campaign. This status also applies to players who have started but haven't completed the free rounds yet. Free rounds for those players remain available even after the expiry date of the campaign.\n\n* COMPLETED - The player consumed all available free rounds, and any winnings have been awarded (issued to the Operator).\n\n* EXPIRED - The expiry date for free rounds has been reached, the promotion has been removed from player accounts, and any players who have not participated yet are not able to complete the promotion.",
            "example": "QUEUED"
          }
        }
      },
      "PagingInfo": {
        "type": "object",
        "properties": {
          "pageNumber": {
            "type": "integer",
            "format": "int32",
            "default": 1,
            "description": "Page number",
            "example": 1
          },
          "pageSize": {
            "type": "integer",
            "format": "int32",
            "default": 50,
            "description": "Page size",
            "example": 10
          },
          "sortBy": {
            "type": "string",
            "default": "id",
            "description": "Field to sort by",
            "example": "id"
          },
          "order": {
            "type": "string",
            "default": "ASCENDING",
            "description": "Sort order. Parameter for pagination. Possible values: ASCENDING, DESCENDING",
            "example": "ASCENDING"
          }
        }
      },
      "PagingMetadata": {
        "type": "object",
        "properties": {
          "pagingInfo": {
            "$ref": "#/components/schemas/PagingInfo",
            "description": "Current pagination parameters including page size and offset"
          },
          "totalNumberOfElements": {
            "type": "integer",
            "format": "int64",
            "description": "Total number of elements across all pages",
            "example": 250
          }
        }
      },
      "SearchResultParticipantDtoLong": {
        "type": "object",
        "properties": {
          "content": {
            "type": "array",
            "description": "List of results matching the search criteria",
            "items": {
              "$ref": "#/components/schemas/ParticipantDto"
            }
          },
          "total": {
            "type": "integer",
            "format": "int64",
            "description": "Total number of items available (not just in this page)",
            "example": 150
          },
          "_metadata": {
            "$ref": "#/components/schemas/PagingMetadata",
            "description": "Pagination metadata including current page information"
          }
        }
      }
    }
  }
}
```