POST
/
player
/
playtime
curl --request POST \
  --url https://partners-api.forge.gg/player/playtime \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '{
  "last_time_played": "2024-07-16 19:20:30",
  "total_hours": 5,
  "user_email": "user@example.com",
  "wallet_address": "0x1234567890abcdef",
  "blockchain": "ethereum"
}'
{
  "records_processed": 10
}

Headers

​
X-API-Key
string
required

Body

application/json
​
last_time_played
string
required

Session end time for the user.
Format: YYYY-MM-DD HH:mm:ss

Example:

"2024-07-16 19:20:30"

​
total_hours
number
required

Total time played by the user for the current session.

Required range: x >= 0
Example:

5

​
user_email
string
required

Email address used by the user to connect to the game.

Example:

"user@example.com"

​
wallet_address
string

Any web3 wallet used by the user to connect to the game.

Example:

"0x1234567890abcdef"

​
blockchain
enum<string>

Blockchain associated with the shared wallet address.

Available options:
avalanche,
base,
ethereum,
polygon,
ronin,
solana,
sui
Example:

"ethereum"

Response

200
application/json
Successful response
​
records_processed
integer
Example:

10

Was this page helpful?

Suggest editsRaise issue