Get Collections
Get all collections for the authenticated member
/members/me/collectionsOverview
Returns all collections belonging to the authenticated member. Collections are used to organize favorited properties into groups like "Honeymoon Destinations", "Business Travel", or "Weekend Getaways".
Authentication
Requires a valid Clerk JWT token in the Authorization header.
Request
curl -X GET "http://localhost:3000/v1/members/me/collections" \
-H "Authorization: Bearer YOUR_CLERK_JWT"Response
collectionsarrayrequiredArray of collection objects
array items
idnumberrequiredUnique collection ID
externalIdstringrequiredExternal identifier for the collection
namestringrequiredDisplay name of the collection
notesstringOptional notes or description for the collection
isSystembooleanrequiredWhether this is a system-managed collection (read-only)
itemCountnumberrequiredNumber of properties in this collection
itemsarrayrequiredPreview of properties in the collection
array items
propertyDocumentIdstringrequiredProperty document identifier
propertyNamestringrequiredProperty name
propertySlugstringProperty URL slug
heroImageUrlstringProperty hero image URL
addedAtstringrequiredISO 8601 timestamp when property was added to collection
createdAtstringrequiredISO 8601 timestamp when collection was created
updatedAtstringrequiredISO 8601 timestamp when collection was last updated
Response
[
{
"id": 1,
"externalId": "coll_123abc",
"name": "Honeymoon Destinations",
"notes": "Romantic properties for our upcoming honeymoon trip",
"isSystem": false,
"itemCount": 3,
"items": [
{
"propertyDocumentId": "prop_luxury_maldives",
"propertyName": "Luxury Resort Maldives",
"propertySlug": "luxury-resort-maldives",
"heroImageUrl": "https://cdn.journey.com/properties/maldives-hero.jpg",
"addedAt": "2024-04-15T14:30:00Z"
},
{
"propertyDocumentId": "prop_santorini_villa",
"propertyName": "Santorini Villa",
"propertySlug": "santorini-villa",
"heroImageUrl": "https://cdn.journey.com/properties/santorini-hero.jpg",
"addedAt": "2024-04-16T09:20:00Z"
}
],
"createdAt": "2024-04-15T10:00:00Z",
"updatedAt": "2024-04-16T09:20:00Z"
},
{
"id": 2,
"externalId": "coll_456def",
"name": "Business Travel",
"notes": null,
"isSystem": false,
"itemCount": 5,
"items": [
{
"propertyDocumentId": "prop_tokyo_business",
"propertyName": "Tokyo Business Hotel",
"propertySlug": "tokyo-business-hotel",
"heroImageUrl": "https://cdn.journey.com/properties/tokyo-business-hero.jpg",
"addedAt": "2024-04-10T16:45:00Z"
}
],
"createdAt": "2024-04-10T16:00:00Z",
"updatedAt": "2024-04-12T11:30:00Z"
},
{
"id": 0,
"externalId": "default",
"name": "Favorites",
"notes": null,
"isSystem": true,
"itemCount": 2,
"items": [
{
"propertyDocumentId": "prop_paris_boutique",
"propertyName": "Paris Boutique Hotel",
"propertySlug": "paris-boutique-hotel",
"heroImageUrl": "https://cdn.journey.com/properties/paris-boutique-hero.jpg",
"addedAt": "2024-04-08T12:15:00Z"
}
],
"createdAt": "2024-01-01T00:00:00Z",
"updatedAt": "2024-04-08T12:15:00Z"
}
]Collection Types
User Collections
- isSystem: false: Created and managed by the member
- Editable: Name and notes can be modified
- Deletable: Can be deleted along with all favorites
System Collections
- isSystem: true: System-managed collections
- Default: The main "Favorites" collection (ID: 0)
- Read-only: Cannot be edited or deleted
Item Preview
Each collection includes a preview of its items showing:
- Property basic information (name, image)
- When the property was added to the collection
- Limited to recent items (full list available via Get Favorites)
Related Endpoints
- Create Collection - Create a new collection
- Get Favorites - Get all favorites, optionally filtered by collection