---
title: "Buy a parcel from a user (System buys from User)"
method: POST
path: "/api/v1/realtor/buy"
tags: ["parcels", "realtor"]
---

# Buy a parcel from a user (System buys from User)

`POST /api/v1/realtor/buy`

## Request

- Base URL: `http://localhost:3000`
- URL: `http://localhost:3000/api/v1/realtor/buy`
- Auth: HTTP bearer

Buy a parcel from a user (System buys from User)

## Request body

- object
  - `serverId` number, required
  - `parcelId` number, required
  - `amount` number, required
  - `force` boolean: Skip game server update if offline

## Response `200`

Default Response

- object
  - `success` true, required
  - `data` object, required
    - `message` string
    - `gameServerAssigned` boolean
  - `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)
