# Get Balance ## Description >Before players log into Besoft's games, Besoft needs to obtain the actual amount of money from the game operator (Host) on the players. >Request method:(BeSoft -> Host):post > The request data format issued by Besoft: application/json > Host The returned data format : application/json ## Method URL > Provided by the game operator (Host). >https://{host}/[notify_url] >http://{host}/[notify_url] | Name | Type | Required | Description | | -------- | -------- | -------- | -------- | | action | int32 | Y | 1,Request score identifier | | uid |string | Y | test1(host)Player account provided by the game operator | | ts | string(14) | Y | Unix timestamp of the message request | | currency| string(3) | Y | Currency code for USD | | gid| string(20) | Y | Unique ID to enter the game | ## 4.3.4 Return Result | Name | Type | Description | | -------- | -------- | -------- | | action | int32 | 1 ,Return request score identifier| | status |int32| status code ,Type int32_tRef 6.Status Code | | balance | double | User's current latest score, accurate to four decimal places as a valid floating point number | | currency| string(3) | USD currency code | ## 4.3.5 Successful Result >{"action":1,"status":1,"balance":10000.0156,"currency":"USD"} ## 4.3.6 Failed Result >{"status": 1003}