Billing

The Featured auction spot

One listing sits above Platinum: the Featured spot, held by whoever paid the most (one-time payment). Returns the current holder (or null) and what taking the spot costs right now — the holder's price plus $1, or $50 when nobody holds it.

get/api/featured

Request

  • Base URL: https://curlship.com
  • URL: https://curlship.com/api/featured
  • Auth: none declared

Response

Current holder and next bid

okboolean
next_bid_usdnumber
next_bid_centsinteger
currencystring

Example response

{
  "ok": true,
  "featured": {
    "id": 2076,
    "url": "https://yourapp.com/",
    "title": "YourApp — ship faster",
    "created_at": "2026-10-12T09:04:05Z"
  },
  "next_bid_usd": 50,
  "next_bid_cents": 5000,
  "currency": "USD"
}

Changes

No recorded changes to this operation across all 1 revision of this API.