Skip to main content
GET
/
api
/
users
/
{id}
/
collections
Get User Collections
curl --request GET \
  --url https://api.example.com/api/users/{id}/collections

​
Authentication

Optional. If authenticated and viewing own profile, shows both public and private collections. Otherwise only public.

​
Path Parameters

ParameterTypeDescription
idstringUsername or UUID

​
Query Parameters

ParameterTypeDefaultDescription
pageinteger1Page number
limitinteger12Items per page
allstring—Set to true to fetch all without pagination

​
Visibility Rules

  • Own profile: sees all collections (public + private)
  • Other users: sees only is_public = true collections

​
Response

{
  "collections": [
    {
      "id": "uuid",
      "name": "Street Photography",
      "description": "My favorite street recipes",
      "coverImageUrl": "https://...",
      "previewImages": ["https://..."],
      "recipeCount": 8,
      "isPublic": true,
      "favoriteCount": 12,
      "commentCount": 0,
      "repostCount": 2,
      "isFavorited": false,
      "isReposted": false,
      "createdAt": "2025-01-15T10:30:00Z",
      "updatedAt": "2025-01-20T14:00:00Z",
      "author": {
        "id": "uuid",
        "username": "filmshooter",
        "avatarUrl": "https://..."
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 12,
    "total": 3,
    "totalPages": 1
  }
}
Cover images are derived from the most recently added saved item’s content (recipe or post cover image).