Skip to main content
GET
/
v1
/
groups
curl https://api.bouncy.ai/v1/groups \
  -H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"
const response = await fetch('https://api.bouncy.ai/v1/groups', {
  headers: {
    'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'
  }
});

const { groups } = await response.json();
console.log(`You have ${groups.length} groups`);
import requests

response = requests.get(
    'https://api.bouncy.ai/v1/groups',
    headers={'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'}
)

data = response.json()
print(f"You have {len(data['groups'])} groups")
{
  "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

Response

groups
array
Array of group objects
curl https://api.bouncy.ai/v1/groups \
  -H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"
const response = await fetch('https://api.bouncy.ai/v1/groups', {
  headers: {
    'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'
  }
});

const { groups } = await response.json();
console.log(`You have ${groups.length} groups`);
import requests

response = requests.get(
    'https://api.bouncy.ai/v1/groups',
    headers={'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'}
)

data = response.json()
print(f"You have {len(data['groups'])} groups")
{
  "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"
    }
  ]
}