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"
}
]
}
Groups
List Groups
Retrieve all your groups with link counts
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
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"
}
]
}
⌘I