---
title: "List active listings"
method: GET
path: "/api/listings"
tags: ["Listings"]
---

# List active listings

`GET /api/listings`

## Request

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

With no query string, returns every active listing as JSON, in the same order as before. Optional query parameters narrow that list and do not add a new response envelope.

`limit` and `offset` page the directory (default limit 50). `q` is a substring of the title, description, or URL (default limit 100). `since` is an ISO timestamp; only listings created at or after that moment are returned. Each listing includes `created_at`. There is no category or tag filter.

## Query parameters

- `limit` integer
- `offset` integer
- `q` string
- `since` string, date-time

## Response `200`

Active listings

- object
  - `ok` boolean
  - `listings` 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`: limit or offset is not a non-negative integer, or since is not an ISO timestamp

---

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