List Pages

Returns a list of all Link-in-Bio pages belonging to the authenticated workspace, including both published and unpublished pages.

GET /v1/bio/pages

bio:read

Parameters

This endpoint takes no parameters.

Request examples

curl

curl https://xqr.co/api/v1/bio/pages \
  -H "Authorization: Bearer YOUR_API_KEY"

TypeScript

const res = await fetch("https://xqr.co/api/v1/bio/pages", {
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
  },
});

const { data, meta } = await res.json();

Python

import httpx

res = httpx.get(
    "https://xqr.co/api/v1/bio/pages",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)

pages = res.json()["data"]

Response

200 OK

{
  "data": [
    {
      "id": "bio_abc123",
      "title": "Acme Inc",
      "description": "Official links and resources",
      "slug": "acme-inc",
      "page_data": {
        "theme": "dark",
        "avatar_url": "https://cdn.xqr.co/avatars/acme.png",
        "links": [
          { "label": "Website", "url": "https://acme.com" },
          { "label": "Twitter", "url": "https://twitter.com/acme" }
        ]
      },
      "is_published": true,
      "published_at": "2026-03-15T14:00:00Z",
      "view_count": 1247,
      "click_count": 892,
      "html_url": "https://bio.xqr.co/acme-inc",
      "created_at": "2026-03-10T10:00:00Z",
      "updated_at": "2026-03-20T16:30:00Z"
    },
    {
      "id": "bio_def456",
      "title": "Product Launch",
      "description": "Links for the spring product launch",
      "slug": "product-launch",
      "page_data": {
        "theme": "light",
        "links": [
          { "label": "Pre-order", "url": "https://acme.com/preorder" }
        ]
      },
      "is_published": false,
      "published_at": null,
      "view_count": 0,
      "click_count": 0,
      "html_url": "https://bio.xqr.co/product-launch",
      "created_at": "2026-03-21T08:00:00Z",
      "updated_at": "2026-03-21T08:00:00Z"
    }
  ],
  "meta": {
    "request_id": "req_v4w5x6",
    "rate_limit": {
      "remaining": 94,
      "reset_at": "2026-03-21T12:01:00Z"
    }
  }
}