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

# PFSegmentsGetPlayersInSegmentRequest

> PFSegmentsGetPlayersInSegmentRequest data model. Initial request must contain at least a Segment ID. Subsequent requests must contain the Segment ID as well.

PFSegmentsGetPlayersInSegmentRequest data model. Initial request must contain at least a Segment ID. Subsequent requests must contain the Segment ID as well as the Continuation Token. Failure to send the Continuation Token will result in a new player segment list being generated. Each time the Continuation Token is passed in the length of the Total Seconds to Live is refreshed. If too much time passes between requests to the point that a subsequent request is past the Total Seconds to Live an error will be returned and paging will be terminated. This API is resource intensive and should not be used in scenarios which might generate high request volumes. Only one request to this API at a time should be made per title. Concurrent requests to the API may be rejected with the APIConcurrentRequestLimitExceeded error.

## Syntax

```cpp theme={null}
typedef struct PFSegmentsGetPlayersInSegmentRequest {  
    const char* continuationToken;  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    bool const* getProfilesAsync;  
    uint32_t const* maxBatchSize;  
    uint32_t const* secondsToLive;  
    const char* segmentId;  
} PFSegmentsGetPlayersInSegmentRequest;  
```

### Members

**`continuationToken`**   const char\*<br />*is null-terminated*

(Optional) Continuation token if retrieving subsequent pages of results.

**`customTags`**   [PFStringDictionaryEntry](/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry) const\*<br />*may be nullptr*

(Optional) The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).

**`customTagsCount`**   uint32\_t

Count of customTags

**`getProfilesAsync`**   bool const\*<br />*may be nullptr*

(Optional) If set to true, the profiles are loaded asynchronously and the response will include a continuation token and approximate profile count until the first batch of profiles is loaded. Use this parameter to help avoid network timeouts.

**`maxBatchSize`**   uint32\_t const\*<br />*may be nullptr*

(Optional) Maximum is 10,000. The value 0 will prevent loading any profiles and return only the count of profiles matching this segment.

**`secondsToLive`**   uint32\_t const\*<br />*may be nullptr*

(Optional) Number of seconds to keep the continuation token active. After token expiration it is not possible to continue paging results. Default is 300 (5 minutes). Maximum is 5,400 (90 minutes).

**`segmentId`**   const char\*<br />*is null-terminated*

Unique identifier for this segment.

## Requirements

**Header:** PFSegmentsTypes.h

## See also

[PFSegmentsTypes members](/services/playfab/api-references/c/pfsegmentstypes/pfsegmentstypes_members)


## Related topics

- [PFSegmentsServerGetPlayersInSegmentAsync](/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayersinsegmentasync.md)
- [Services C API overview - PFSegmentsTypes.h](/services/playfab/api-references/c/pfsegmentstypes/pfsegmentstypes_members.md)
- [PFSegmentsGetPlayersSegmentsRequest](/services/playfab/api-references/c/pfsegmentstypes/structs/pfsegmentsgetplayerssegmentsrequest.md)
- [PFSegmentsServerGetPlayerSegmentsAsync](/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayersegmentsasync.md)
- [PFSegmentsGetPlayerTagsRequest](/services/playfab/api-references/c/pfsegmentstypes/structs/pfsegmentsgetplayertagsrequest.md)