HelpBlog
Features
About
Login
Sign Up

Help

Public Profiles

Endpoints in this group return content marked public by its owner. They require no authentication and may be called from any client. Private content is excluded from responses.

Namespace note (singular vs. plural, intentional: use the exact spelling).

  • A user's public message feed is under singular user: GET /api/user/{username}/messages. The plural form (/api/users/{username}/messages) 404s.
  • A user's public profile, lists, list data, and documents are under plural users: GET /api/users/{username}, /api/users/{username}/lists, /api/users/{username}/lists/{id}/data, /api/users/{username}/documents. The singular form of these 404s.

Endpoint table

MethodPathDescription
GET/api/users/:usernameThe user's viewer-aware public profile object. Auth optional: a private account's bio is withheld from unauthenticated callers and non-followers. 404 { error: "user_not_found" } if no such user.
GET/api/users/:username/listsPublic lists owned by the user.
GET/api/users/:username/lists/:idA specific public list (metadata + schema).
GET/api/users/:username/lists/:id/dataRows from a specific public list.
GET/api/users/:username/documentsPublic documents owned by the user.

/api/user/:username/messages (note the singular user) is also a public-by-default endpoint: the viewer sees the user's public messages without authenticating; if the requester is the owner, private messages are included.

Fetching a public list

curl https://interlinedlist.com/api/users/somehandle/lists/lst_abc001

Response (200):

{
  "id": "lst_abc001",
  "title": "Books to Read",
  "description": "My reading backlog.",
  "isPublic": true,
  "schema": "Title:text, Author:text, Year:number, Read:boolean",
  "owner": { "username": "somehandle", "displayName": "Some One" },
  "createdAt": "2025-06-11T08:30:00.000Z"
}

Fetching list rows

curl "https://interlinedlist.com/api/users/somehandle/lists/lst_abc001/data?limit=50&offset=0"

Response (200): the same paginated row shape as the authenticated GET /api/lists/:id/data.

Pagination

limit and offset query params are supported on the list and document endpoints. The response includes a pagination object with total, limit, offset, and hasMore.

Privacy notes

  • A list marked isPublic: false returns 404 from these endpoints, not 403.
  • Documents marked isPublic: false are likewise excluded.
  • These endpoints never reveal email addresses or any non-public profile field.
  • Users and Profile: endpoints for the currently authenticated user.
  • API overview: base URL, authentication at a glance, and response conventions.
  • API explorer: try public profile endpoints live with the interactive Swagger console.