---
title: "Request parcel auction or hold (authenticated users)"
method: POST
path: "/api/v1/parcels/{parcelId}/request-interest"
tags: ["parcels", "interest-requests"]
---

# Request parcel auction or hold (authenticated users)

`POST /api/v1/parcels/{parcelId}/request-interest`

## Request

- Base URL: `http://localhost:3000`
- URL: `http://localhost:3000/api/v1/parcels/{parcelId}/request-interest`
- Auth: HTTP bearer

Request parcel auction or hold (authenticated users)

## Path parameters

- `parcelId` string, required

## Request body

- object
  - `interestType` 'AUCTION' | 'HOLD', required: Type of interest request

## Response `200`

Default Response

- object
  - `success` true, required
  - `data` object, required
    - `request` object
      - `id` string
      - `parcelId` string
      - `userId` string
      - `serverId` number
      - `interestType` string
      - `status` string
      - `createdAt` string
      - `expiresAt` string, nullable
      - `reviewedAt` string, nullable
      - `reviewedBy` string, nullable
      - `realtorNotes` string, nullable
      - `server` object, nullable
        - `id` number
        - `name` string
        - `mapName` string, nullable
      - `user` object, nullable
        - `discordId` string
        - `username` string, nullable
        - `nickname` string, nullable
        - `image` string, nullable
      - `parcel` object
        - `id` string
        - `fieldNumber` number
        - `serverId` number
        - `ownerId` string, nullable
        - `price` number, nullable
        - `fieldSize` number, nullable
        - `parcelSize` number, nullable
        - `fieldDescription` string, nullable
        - `mapName` string, nullable
        - `image` string, nullable
        - `owner` object, nullable
          - `discordId` string
          - `username` string, nullable
          - `nickname` string, nullable
          - `image` string, nullable
        - `holdBy` object, nullable
          - `discordId` string
          - `username` string, nullable
          - `nickname` string, nullable
          - `image` string, nullable
      - `reviewer` object, nullable
        - `discordId` string
        - `username` string, nullable
        - `nickname` string, nullable
        - `image` string, nullable
  - `meta` object, required
    - `timestamp` number, required

## Other responses

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