Smart Links

List a project's links

curl "https://api.subscriby.net/v1/projects/7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13/links?archived=false&per_page=25&page=1" \
  -H "Authorization: Bearer sbt_..."

Pages the project's links, newest first, live and archived alike unless archived says otherwise; search finds links whose name or slug contains the text. Every row carries the three addresses in urls.

archived=false keeps expired links too: they are still the creator's and still carry their figures. Read state on each row, which is live, expired or archived.

get/v1/projects/{project}/links

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/projects/{project}/links
  • Auth: HTTP bearer

Path parameters

projectstring uuid required

The project, resolved by the route binder.

Query parameters

archived'true' | 'false' | '1' | '0'

Keep only archived links (true) or only links still in use (false), expired ones included. Omit for every link.

searchstring

Find links whose name or slug contains this text, case-insensitively.

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.

limitinteger

Legacy alias of per_page, kept for clients that predate it. per_page wins when both are sent.

Response

The page of links, newest first, each with its three addresses.

Example response

{
  "data": [
    {
      "id": "1e2a4c6b-3d5f-4a7b-9c1d-2e3f4a5b6c7d",
      "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
      "name": "YouTube description",
      "slug": "youtube",
      "code": "TUBE234",
      "destination": {
        "type": "plan",
        "plan_id": "0c9d8e7f-6a5b-4c3d-8e2f-1a2b3c4d5e6f",
        "plan_name": "Premium"
      },
      "urls": {
        "web": "https://my.subscriby.net/research-premium/go/youtube",
        "bot": "https://t.me/ResearchPremiumBot?start=via_TUBE234",
        "embed": "https://my.subscriby.net/research-premium/embed/plans?via=TUBE234"
      },
      "state": "live",
      "clicks": {
        "total": 42,
        "last_at": "2026-10-10T08:00:00+00:00"
      },
      "created_at": "2026-10-01T09:00:00+00:00",
      "updated_at": "2026-10-10T08:00:00+00:00"
    }
  ]
}

Changes

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