---
title: "The Featured auction spot"
method: GET
path: "/api/featured"
tags: ["Billing"]
---

# The Featured auction spot

`GET /api/featured`

## Request

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

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.

## Response `200`

Current holder and next bid

- object
  - `ok` boolean
  - `featured` Listing
    - `id` integer
    - `url` string, uri
    - `tier` 'free' | 'bronze' | 'silver' | 'gold' | 'platinum'
    - `title` string, nullable
    - `description` string, nullable
    - `image` string, uri, nullable
    - `has_badge` boolean: True if a dofollow link back to curlship.com was found on the site.
    - `created_at` string, date-time, nullable: When the listing was created, UTC.
  - `next_bid_usd` number
  - `next_bid_cents` integer
  - `currency` string

---

[API](https://skmtc.dev/curlship/apis/curlship-api.md) · [All operations](https://skmtc.dev/curlship/apis/curlship-api/llms.txt) · [OpenAPI document](https://skmtc.dev/curlship/apis/curlship-api/revisions/96fedc05adda?raw)