Get Player Statistics

Retrieves the indicated statistics (current version and values for all statistics, if none are specified), for the local player.

Error codes

This operation may return the following PlayFab errors:

Error	Code
ProductDisabledForTitle	1609

POST

Client

GetPlayerStatistics

Get Player Statistics

curl --request POST \
  --url https://{titleId}.playfabapi.com/Client/GetPlayerStatistics \
  --header 'Content-Type: application/json' \
  --header 'X-Authorization: <api-key>' \
  --data '
{
  "StatisticNames": [
    "Points",
    "Wins"
  ]
}
'

import requests

url = "https://{titleId}.playfabapi.com/Client/GetPlayerStatistics"

payload = { "StatisticNames": ["Points", "Wins"] }
headers = {
    "X-Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-Authorization': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({StatisticNames: ['Points', 'Wins']})
};

fetch('https://{titleId}.playfabapi.com/Client/GetPlayerStatistics', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{titleId}.playfabapi.com/Client/GetPlayerStatistics",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'StatisticNames' => [
        'Points',
        'Wins'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{titleId}.playfabapi.com/Client/GetPlayerStatistics"

	payload := strings.NewReader("{\n  \"StatisticNames\": [\n    \"Points\",\n    \"Wins\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{titleId}.playfabapi.com/Client/GetPlayerStatistics")
  .header("X-Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"StatisticNames\": [\n    \"Points\",\n    \"Wins\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{titleId}.playfabapi.com/Client/GetPlayerStatistics")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"StatisticNames\": [\n    \"Points\",\n    \"Wins\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "code": 200,
  "status": "OK",
  "data": {
    "Statistics": [
      {
        "StatisticName": "Points",
        "Value": 570,
        "Version": 2
      },
      {
        "StatisticName": "Wins",
        "Value": 15
      }
    ]
  }
}

{
  "code": 123,
  "errorCode": 123,
  "status": "<string>",
  "error": "<string>",
  "errorMessage": "<string>",
  "errorDetails": {}
}

Authorizations

X-Authorization

string

header

required

This API requires a client session ticket, available from any Client Login function.

Body

application/json

CustomTags

object

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

StatisticNames

string[]

statistics to return (current version will be returned for each)

StatisticNameVersions

object[]

statistics to return, if StatisticNames is not set (only statistics which have a version matching that provided will be returned)

Show child attributes

Response

In addition to being available for use by the title, the statistics are used for all leaderboard operations in PlayFab.

code

integer

The Http status code. If X-ReportErrorAsSuccess header is set to true, this will report the actual http error code.

status

string

The Http status code as a string.

data

object

In addition to being available for use by the title, the statistics are used for all leaderboard operations in PlayFab.

Show child attributes

Example:

{
  "Statistics": [
    {
      "StatisticName": "Points",
      "Value": 570,
      "Version": 2
    },
    { "StatisticName": "Wins", "Value": 15 }
  ]
}

Last modified on October 1, 2026

⌘I

Get Player Statistics

curl --request POST \
  --url https://{titleId}.playfabapi.com/Client/GetPlayerStatistics \
  --header 'Content-Type: application/json' \
  --header 'X-Authorization: <api-key>' \
  --data '
{
  "StatisticNames": [
    "Points",
    "Wins"
  ]
}
'

import requests

url = "https://{titleId}.playfabapi.com/Client/GetPlayerStatistics"

payload = { "StatisticNames": ["Points", "Wins"] }
headers = {
    "X-Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-Authorization': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({StatisticNames: ['Points', 'Wins']})
};

fetch('https://{titleId}.playfabapi.com/Client/GetPlayerStatistics', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{titleId}.playfabapi.com/Client/GetPlayerStatistics",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'StatisticNames' => [
        'Points',
        'Wins'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{titleId}.playfabapi.com/Client/GetPlayerStatistics"

	payload := strings.NewReader("{\n  \"StatisticNames\": [\n    \"Points\",\n    \"Wins\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{titleId}.playfabapi.com/Client/GetPlayerStatistics")
  .header("X-Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"StatisticNames\": [\n    \"Points\",\n    \"Wins\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{titleId}.playfabapi.com/Client/GetPlayerStatistics")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"StatisticNames\": [\n    \"Points\",\n    \"Wins\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "code": 200,
  "status": "OK",
  "data": {
    "Statistics": [
      {
        "StatisticName": "Points",
        "Value": 570,
        "Version": 2
      },
      {
        "StatisticName": "Wins",
        "Value": 15
      }
    ]
  }
}

{
  "code": 123,
  "errorCode": 123,
  "status": "<string>",
  "error": "<string>",
  "errorMessage": "<string>",
  "errorDetails": {}
}

PlayFab API

PlayFab REST API References

Get Player Statistics

Error codes

Authorizations

Body

Response