---
title: "Transfer field between players (realtor only)"
method: POST
path: "/api/v1/realtor/fields/{fieldId}/transfer"
tags: ["realtor"]
---

# Transfer field between players (realtor only)

`POST /api/v1/realtor/fields/{fieldId}/transfer`

## Request

- Base URL: `http://localhost:3000`
- URL: `http://localhost:3000/api/v1/realtor/fields/{fieldId}/transfer`
- Auth: HTTP bearer

Transfer field between players (realtor only)

## Path parameters

- `fieldId` string, required

## Request body

- object
  - `newOwnerId` string, required: Discord ID of new owner
  - `amount` number, required: Transfer amount (buyer pays this)
  - `serverId` number, required: Server ID

## Response `200`

Default Response

- object
  - `success` true, required
  - `data` object, required
    - `field` object
      - `id` string
      - `serverId` number
      - `fieldNumber` number
      - `ownerId` string
      - `price` number, nullable
      - `fieldSize` number, nullable
      - `parcelSize` number, nullable
      - `fieldDescription` string, nullable
      - `mapName` string, nullable
      - `image` string, nullable
      - `updatedAt` string
      - `owner` object
        - `discordId` string
        - `username` string, nullable
        - `farmName` string, nullable
        - `image` string, nullable
    - `buyerTransaction` object
      - `id` number
      - `userId` string
      - `fromId` string, nullable
      - `toId` string, nullable
      - `amount` number
      - `before` number, nullable
      - `after` number, nullable
      - `account` string
      - `type` string, nullable
      - `memo` string, nullable
      - `timestamp` string
    - `sellerTransaction` object
      - `id` number
      - `userId` string
      - `fromId` string, nullable
      - `toId` string, nullable
      - `amount` number
      - `before` number, nullable
      - `after` number, nullable
      - `account` string
      - `type` string, nullable
      - `memo` string, nullable
      - `timestamp` string
    - `feeTransaction` object
      - `id` number
      - `userId` string
      - `fromId` string, nullable
      - `toId` string, nullable
      - `amount` number
      - `before` number, nullable
      - `after` number, nullable
      - `account` string
      - `type` string, nullable
      - `memo` string, nullable
      - `timestamp` string
    - `transferFee` number
  - `meta` object, required
    - `timestamp` number, required

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `404`: Default Response
- `422`: 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)
