Get Auction by ID

Retrieves details of a specific auction by its unique identifier.

• URI: /api/Auctions/{id}
• Method: GET
• Authentication: Required (JWT)
• Permission Required: Auctions.Read (default value: "AuctionR:Auctions:Read")

🔐 Permission values are configurable via the Permissions section in appsettings.json.

---

Path Parameters

Name	Type	Required	Description
id	int	Yes	Unique identifier of the auction

---

Sample Request

GET /api/Auctions/789 HTTP/1.1
Authorization: Bearer {your_jwt_token}

Response

Status Code: 200 OK

Response Body Example

{
  "success": true,
  "message": "Auction retrieved successfully.",
  "data": {
    "id": 789,
    "productId": 123,
    "ownerId": 456,
    "title": "Vintage Guitar Auction",
    "description": "A well-preserved vintage guitar from the 1960s.",
    "startingPrice": 1500.0,
    "minimumBidIncrement": 100.0,
    "currency": "USD",
    "startTime": "2025-06-10T14:00:00Z",
    "endTime": "2025-06-12T14:00:00Z",
    "status": "Pending"
  }
}

Possible Error Responses

Status Code	Meaning	When it Happens
400	Bad Request	Input validation fails (e.g., missing/invalid fields)
401	Unauthorized	JWT is missing or invalid
403	Forbidden	Caller does not have permission to read auctions
429	Too Many Requests	Rate limiting exceeded
500	Internal Server Error	Unexpected server-side error