Help
Help
Loading help article
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.
| Method | Path | Description |
|---|---|---|
| GET | /api/users/:username | The 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/lists | Public lists owned by the user. |
| GET | /api/users/:username/lists/:id | A specific public list (metadata + schema). |
| GET | /api/users/:username/lists/:id/data | Rows from a specific public list. |
| GET | /api/users/:username/documents | Public 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.
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"
}
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.
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.
isPublic: false returns 404 from these endpoints, not 403.isPublic: false are likewise excluded.