Skip to main content
GET
https://api.bouncy.ai
/
v1
/
groups
curl https://api.bouncy.ai/v1/groups \
  -H "X-Api-Key: bcy_live_pk_YOUR_API_KEY"
{
  "groups": [
    {
      "id": "grp_abc123",
      "name": "Summer Campaign 2026",
      "description": "All links for the summer marketing campaign",
      "color": "#FF5733",
      "linkCount": 15,
      "createdAt": "2026-01-15T10:00:00Z",
      "updatedAt": "2026-02-05T14:30:00Z"
    },
    {
      "id": "grp_def456",
      "name": "Product Launch",
      "description": "Links for new product launch",
      "color": "#3498DB",
      "linkCount": 8,
      "createdAt": "2026-01-20T09:00:00Z",
      "updatedAt": "2026-02-01T11:15:00Z"
    },
    {
      "id": "grp_ghi789",
      "name": "Social Media",
      "description": "General social media links",
      "color": "#2ECC71",
      "linkCount": 23,
      "createdAt": "2025-12-10T08:00:00Z",
      "updatedAt": "2026-02-06T10:00:00Z"
    }
  ]
}

Request

Headers

X-Api-Key
string
required
Your API key (e.g., bcy_live_pk_YOUR_API_KEY)

Response

groups
array
Array of group objects
curl https://api.bouncy.ai/v1/groups \
  -H "X-Api-Key: bcy_live_pk_YOUR_API_KEY"
{
  "groups": [
    {
      "id": "grp_abc123",
      "name": "Summer Campaign 2026",
      "description": "All links for the summer marketing campaign",
      "color": "#FF5733",
      "linkCount": 15,
      "createdAt": "2026-01-15T10:00:00Z",
      "updatedAt": "2026-02-05T14:30:00Z"
    },
    {
      "id": "grp_def456",
      "name": "Product Launch",
      "description": "Links for new product launch",
      "color": "#3498DB",
      "linkCount": 8,
      "createdAt": "2026-01-20T09:00:00Z",
      "updatedAt": "2026-02-01T11:15:00Z"
    },
    {
      "id": "grp_ghi789",
      "name": "Social Media",
      "description": "General social media links",
      "color": "#2ECC71",
      "linkCount": 23,
      "createdAt": "2025-12-10T08:00:00Z",
      "updatedAt": "2026-02-06T10:00:00Z"
    }
  ]
}