POST /auctions/{auctionId}/bid - Fanfare Documentation

POST

auctions

{auctionId}

bid

cURL

curl --request POST \
  --url https://consumer.fanfare.io/api/auctions/{auctionId}/bid \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": "<string>"
}
'

{
  "admissionGrant": "<string>",
  "bidCount": 123,
  "lastBidAmount": "<string>",
  "winningBidAmount": "<string>"
}

Path Parameters

auctionId

string

required

Body

application/json

amount

string

Response

Bid placed successfully

status

enum<string>

required

Available options:

NOT_BID,

BIDDING,

WINNING,

OUTBID,

WON,

LOST

admissionGrant

string

bidCount

number

lastBidAmount

string | null

Pattern: ^\d{1,12}(\.\d{1,8})?$

winningBidAmount

string

Pattern: ^\d{1,12}(\.\d{1,8})?$

GET /auctions/{auctionId}/bidsGet all bids for the auction

cURL

curl --request POST \
  --url https://consumer.fanfare.io/api/auctions/{auctionId}/bid \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": "<string>"
}
'

{
  "admissionGrant": "<string>",
  "bidCount": 123,
  "lastBidAmount": "<string>",
  "winningBidAmount": "<string>"
}