---
title: "Fetch a single listing by id"
method: GET
path: "/api/listing/{id}"
tags: ["Listings"]
---

# Fetch a single listing by id

`GET /api/listing/{id}`

## Request

- Base URL: `https://curlship.com`
- URL: `https://curlship.com/api/listing/{id}`
- Auth: none declared

Returns one active listing as JSON. The id is the one shown in the submit response and in /l/<id> URLs.

## Path parameters

- `id` integer, required

## Response `200`

The listing

- object
  - `ok` boolean
  - `listing` object
    - `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.

## Other responses

- `400`: Id is not an integer
- `404`: No active listing with that id

---

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