GET Collections

GET /brands/{brandId}/collections

Lists all collections belonging to a brand, including a summary of the channels attached to each.

Path parameters

Parameter	Type	Description
brandId	integer	ID from the brands list.

Query parameters:

Parameter	Type	Default	Min	Max	Description
page	integer	1	1	-	Page number.
per_page	integer	10	1	100	Items per page.

Request

curl "https://nuelink.com/api/public/v1/brands/13493/collections?page=1&per_page=10"
  -H "Authorization: Bearer YOUR_API_KEY"

Response: 200 OK

{
   "status":"success",
   "data":[
      {
         "id":98843,
         "title":"Product Launches",
         "description":"Announcements for new skincare drops and collections",
         "status":"ACTIVE",
         "createdAt":"2026-04-08T09:46:21.000000Z",
         "updatedAt":"2026-04-08T09:46:21.000000Z",
         "channels":[

         ]
      },
      {
         "id":40656,
         "title":"Summer Garden Campaign",
         "description":"Seasonal content for the Summer Garden line",
         "status":"ACTIVE",
         "createdAt":"2023-09-19T13:45:26.000000Z",
         "updatedAt":"2025-02-23T10:11:16.000000Z",
         "channels":[
            {
               "id":60111,
               "name":"FernwoodBotanicals",
               "type":"X",
               "status":"ACTIVE",
               "createdAt":"2023-08-10T11:38:53.000000Z",
               "updatedAt":"2026-01-06T10:55:07.000000Z"
            },
            {
               "id":60112,
               "name":"fernwoodbotanicals",
               "type":"Instagram",
               "status":"INACTIVE",
               "createdAt":"2023-08-10T11:39:10.000000Z",
               "updatedAt":"2025-04-06T11:00:17.000000Z"
            }
         ]
      },
      {
         "id":33273,
         "title":"Behind the Scenes",
         "description":"Studio shots and team spotlights",
         "status":"ACTIVE",
         "createdAt":"2023-07-20T13:05:31.000000Z",
         "updatedAt":"2025-02-22T21:20:36.000000Z",
         "channels":[

         ]
      }
   ],
   "pagination":{
      "currentPage":1,
      "perPage":10,
      "total":3,
      "lastPage":1,
      "nextPageUrl":null,
      "prevPageUrl":null
   }
}

Response fields (per collection)

Field	Type	Description
id	integer	Collection identifier. Use as {collectionId} in URLs.
title	string	Display name.
description	string | null	Optional free-text description.
status	string	Current state of the collection (e.g. ACTIVE).
createdAt	string	ISO 8601 timestamp.
updatedAt	string	ISO 8601 timestamp.
channels	array	Channels attached to the collection (see below).

Embedded channel fields

Embedded channels now return the same fields as the standalone GET /channels endpoint:

Field	Type	Description
id	integer	Channel identifier.
name	string	Display name of the social account.
type	string	Platform type (see GET /channels for the full list of values).
status	string	ACTIVE (connected and working) or INACTIVE (disconnected or needs re-auth).
createdAt	string	ISO 8601 timestamp of when the channel was connected.
updatedAt	string	ISO 8601 timestamp.

Error example: brand not found:

Request:

curl https://nuelink.com/api/public/v1/brands/99999999/collections
-H "Authorization: Bearer YOUR_API_KEY"

Response: 404 Not Found

{
  "status": "error",
  "message": "Brand not found.",
  "errors": {
    "brand": "Brand not found."
  }
}