---
title: "Transfer crops to another building/user"
method: POST
path: "/api/v1/servers/{serverId}/buildings/{buildingId}/crops/{cropId}/transfers"
tags: ["crops"]
---

# Transfer crops to another building/user

`POST /api/v1/servers/{serverId}/buildings/{buildingId}/crops/{cropId}/transfers`

## Request

- Base URL: `http://localhost:3000`
- URL: `http://localhost:3000/api/v1/servers/{serverId}/buildings/{buildingId}/crops/{cropId}/transfers`
- Auth: HTTP bearer

Transfer crops to another building/user

## Path parameters

- `serverId` string, required
- `buildingId` string, required
- `cropId` string, required

## Request body

- object
  - `toUserId` string, required: Destination user Discord ID
  - `toServerId` number, required: Destination server ID
  - `toBuildingId` string, required: Destination building ID
  - `amount` number, required: Amount to transfer
  - `memo` string: Transfer memo

## Response `200`

Default Response

- object
  - `success` true, required
  - `data` object, required
    - `success` boolean: Transfer operation success flag
    - `message` string: Success message
    - `transferCost` number: Transfer cost
    - `costBreakdown` object, nullable
      - `totalCost` number: Total transfer cost
      - `totalKg` number: Total crop weight in kilograms
      - `tierRate` number: Base rate for the crop tier
      - `tierName` string: Crop pricing tier name
      - `breakdown` object[]: Per-volume-tier cost breakdown
        - `tierLabel` string: Volume discount tier label
        - `kg` number: Kilograms charged in this tier
        - `rate` number: Base per-kg transfer rate
        - `multiplier` number: Tier discount multiplier
        - `cost` number: Calculated cost for this tier
  - `meta` object, required
    - `timestamp` number, required

## Other responses

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