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

# XblUserStatisticsGetMultipleUserStatisticsAsync

> XblUserStatisticsGetMultipleUserStatisticsAsync

# XblUserStatisticsGetMultipleUserStatisticsAsync

Get statistics for multiple users.

## Syntax

```cpp theme={null}
HRESULT XblUserStatisticsGetMultipleUserStatisticsAsync(  
         XblContextHandle xblContextHandle,  
         uint64_t* xboxUserIds,  
         size_t xboxUserIdsCount,  
         const char* serviceConfigurationId,  
         const char** statisticNames,  
         size_t statisticNamesCount,  
         XAsyncBlock* async  
)  
```

### Parameters

*xblContextHandle*   \_In\_\
Type: [XblContextHandle](/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

XBOX live context for the local user.

*xboxUserIds*   \_In\_\
Type: uint64\_t\*

A list of the user XBOX user IDs to get stats for.

*xboxUserIdsCount*   \_In\_\
Type: size\_t

The number of XBOX user IDs.

*serviceConfigurationId*   \_In\_z\_\
Type: char\*

The Service Configuration ID (SCID) for the title. The SCID is considered case sensitive so paste it directly from the Partner Center.

*statisticNames*   \_In\_\
Type: char\*\*

A collection of statistic names to lookup.

*statisticNamesCount*   \_In\_\
Type: size\_t

The number of statistic names.

*async*   \_In\_\
Type: XAsyncBlock\*

The AsyncBlock for this operation.

### Return value

Type: HRESULT

HRESULT return code for this API operation.

## Remarks

Call [XblUserStatisticsGetMultipleUserStatisticsResultSize](/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetmultipleuserstatisticsresultsize) and [XblUserStatisticsGetMultipleUserStatisticsResult](/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetmultipleuserstatisticsresult) upon completion to get the result. Only statistics with values are returned. For example, if you ask for 3 statistic names and only 2 have values, only 2 statistics are returned by the service.

If using [event-based Stats](/services/xbox-services/player-data/stats-leaderboards/event-based/live-stats-eb-overview), statistic names will coincide with each stat's [stat instance](/services/xbox-services/player-data/stats-leaderboards/event-based/live-stats-eb-overview#defining-stat-instances). If using [title-managed Stats](/services/xbox-services/player-data/stats-leaderboards/title-managed/live-stats-tm-overview), statistic names will coincide with each stat's ID.

## REST Call

V1 POST /batch

## Requirements

**Header:** user\_statistics\_c.h

**Library:** Microsoft.Xbox.Services.14x.GDK.C.lib

## See also

[user\_statistics\_c](/reference/live/xsapi-c/user_statistics_c/user_statistics_c_members)


## Related topics

- [XblUserStatisticsGetMultipleUserStatisticsResult](/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetmultipleuserstatisticsresult.md)
- [XblUserStatisticsGetMultipleUserStatisticsResultSize](/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetmultipleuserstatisticsresultsize.md)
- [Getting event-based stats](/services/xbox-services/player-data/stats-leaderboards/event-based/how-to/live-getting-eb-stat.md)
- [XblUserStatisticsGetMultipleUserStatisticsForMultipleServiceConfigurationsAsync](/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetmultipleuserstatisticsformultipleserviceconfigurationsasync.md)
- [XblUserStatisticsGetMultipleUserStatisticsForMultipleServiceConfigurationsResult](/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetmultipleuserstatisticsformultipleserviceconfigurationsresult.md)