---
title: "Get user financial information (requires money:view:others permission)"
method: GET
path: "/api/v1/users/{userId}/balance"
tags: ["users"]
---

# Get user financial information (requires money:view:others permission)

`GET /api/v1/users/{userId}/balance`

## Request

- Base URL: `http://localhost:3000`
- URL: `http://localhost:3000/api/v1/users/{userId}/balance`
- Auth: HTTP bearer

Get user financial information (requires money:view:others permission)

## Path parameters

- `userId` string, required

## Response `200`

Default Response

- object
  - `success` true, required
  - `data` object, required
    - `userInfo` object
      - `discordId` string
      - `username` string
      - `checking` number
      - `landTokens` number
      - `eventPoints` number
      - `points` number
      - `farmName` string, nullable
      - `server` number, nullable
    - `loans` object[]
      - `id` string
      - `loanId` string
      - `currentBalance` number
      - `active` boolean
    - `ingameBalance` object, nullable
      - `balance` number: In-game money balance
      - `loan` number: In-game loan balance
      - `serverId` number: Server ID
      - `farmName` string: Farm name
  - `meta` object, required
    - `timestamp` number, required

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `404`: Default Response
- `500`: Default Response

---

[API](https://skmtc.dev/farmersonly/apis/farmersonly-club-api.md) - [All operations](https://skmtc.dev/farmersonly/apis/farmersonly-club-api/llms.txt) - [OpenAPI document](https://skmtc.dev/farmersonly/apis/farmersonly-club-api/revisions/b4fa9123ba90?raw)
