---
title: "Finalize an ended auction (Realtor-only)"
method: POST
path: "/api/v1/parcels/realtor/auctions/{auctionId}/finalize"
tags: ["realtor", "parcels", "auctions"]
---

# Finalize an ended auction (Realtor-only)

`POST /api/v1/parcels/realtor/auctions/{auctionId}/finalize`

## Request

- Base URL: `http://localhost:3000`
- URL: `http://localhost:3000/api/v1/parcels/realtor/auctions/{auctionId}/finalize`
- Auth: HTTP bearer

Finalize an ended auction (Realtor-only)

## Path parameters

- `auctionId` string, required

## Response `200`

Default Response

- object
  - `success` true, required
  - `data` object, required
    - `message` string, required
    - `outcome` 'COMPLETED' | 'INSUFFICIENT_FUNDS' | 'FIELD_UNAVAILABLE' | 'NO_BIDS' | 'CANCELLED'
    - `gameServerAssigned` boolean
  - `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

## Changes

- **2026-09-04** `871316f42296`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/farmersonly/apis/farmersonly-club-api/changes/api/v1/parcels/realtor/auctions/:auctionId/finalize/post.md)

---

[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)
