---
title: "Get latest data for a specific player"
method: GET
path: "/get-player-data"
tags: ["GET"]
---

# Get latest data for a specific player

`GET /get-player-data`

# Notes

* Query parameter `<block_id>` must be the latest block. Use `/get-block` endpoint

* Query parameter `<player_id>` must be a valid player id

* Only includes active deposits

## Query parameters

- `block_id` string, required
- `player_id` string, required

## Response `200`

Success

- GetPlayerDataResponse
  - `player` Player
    - `id` string
    - `details` PlayerDetails
      - `name` string, nullable
      - `x` string, nullable — X (Twitter) handle
      - `telegram` string, nullable — Telegram username
      - `discord` string, nullable — Discord username
      - `is_multisig` boolean
    - `state` PlayerState
      - `total_fees_paid` string
      - `available_fee_balance` string
      - `delegatee` PlayerValueDelegatee
        - `value` string
        - `block_set` integer
      - `votes` object
      - `reward_share` number, double
    - `block_data` PlayerBlockData
      - `delegatee` string, nullable
      - `reward_by_type` object
        - `algorithm` string
        - `benchmarker` string
        - `advance` string
        - `delegator` string
      - `deposit_by_locked_period` PreciseNumber[]
      - `weighted_deposit` string
  - `deposits` Deposit[]
    - `id` string
    - `details` DepositDetails
      - `player_id` string
      - `tx_hash` string
      - `log_idx` integer
      - `amount` string
      - `start_timestamp` integer
      - `end_timestamp` integer
    - `state` DepositState
      - `block_confirmed` integer
  - `topups` TopUp[]
    - `id` string
    - `details` TopUpDetails
      - `player_id` string
      - `tx_hash` string
      - `log_idx` integer
      - `amount` string
    - `state` TopUpState
      - `block_confirmed` integer

---

[API](https://skmtc.net/tig-foundation/apis/the-innovation-game-api.md) · [All operations](https://skmtc.net/tig-foundation/apis/the-innovation-game-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tig-foundation/the-innovation-game-api/versions/2af9c398c1d4/schema)