Projects

List projects

curl https://api.subscriby.net/v1/projects \
  -H "Authorization: Bearer $SUBSCRIBY_TOKEN"

Every project visible to the token, newest first, paged with page and per_page (default 25). A token minted with scope:project:<uuid> entries lists only those projects.

get/v1/projects

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/projects
  • Auth: HTTP bearer

Query parameters

pageinteger

The 1-based page to return. A page past the last answers an empty data array with meta.total still filled, so a loop can stop without guessing.

per_pageinteger

Rows per page, 1 to 100. A higher value clamps to the cap silently. Defaults to 25.

sort_bystring

The column to order by. Defaults to created_at; a column the endpoint does not offer falls back to the default rather than failing.

sort_direction'asc' | 'desc'

asc or desc. Defaults to desc.

Response

The page, newest first.

Example response

{
  "data": [
    {
      "id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
      "team_id": "a83f0d51-4c92-4b7e-8615-2fd9e70a3c86",
      "user_id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80",
      "name": "Research Premium",
      "handle": "research-premium",
      "description": "Weekly deep-dive research notes.",
      "terms": "https://example.com/terms",
      "privacy": "https://example.com/privacy",
      "banner_url": "https://static.subscriby.net/projects/7f3d1c92/banner.webp",
      "photo_url": "https://static.subscriby.net/projects/7f3d1c92/photo.webp",
      "metrics": true,
      "outage_compensations": true,
      "active": true,
      "created_at": "2026-05-18T10:05:00Z",
      "updated_at": "2026-05-18T10:05:00Z"
    }
  ]
}

Changes

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