curl https://api.bouncy.ai/v1/geo-presets \
-H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"
const response = await fetch('https://api.bouncy.ai/v1/geo-presets', {
headers: {
'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'
}
});
const { presets } = await response.json();
console.log(`You have ${presets.length} geo presets`);
import requests
response = requests.get(
'https://api.bouncy.ai/v1/geo-presets',
headers={'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'}
)
data = response.json()
print(f"You have {len(data['presets'])} geo presets")
{
"success": true,
"presets": [
{
"id": "a1B2c3D4e5F6g7H8",
"name": "UK and US",
"countries": ["US", "GB"],
"createdAt": "2026-01-15T10:00:00Z",
"updatedAt": "2026-02-05T14:30:00Z"
},
{
"id": "z9Y8x7W6v5U4t3S2",
"name": "Core EU markets",
"countries": ["DE", "FR", "ES", "IT"],
"createdAt": "2026-01-20T09:00:00Z",
"updatedAt": "2026-01-20T09:00:00Z"
}
]
}
Geo Presets
List Geo Presets
Retrieve your saved geo presets, reusable country sets for geo filtering
GET
/
v1
/
geo-presets
curl https://api.bouncy.ai/v1/geo-presets \
-H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"
const response = await fetch('https://api.bouncy.ai/v1/geo-presets', {
headers: {
'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'
}
});
const { presets } = await response.json();
console.log(`You have ${presets.length} geo presets`);
import requests
response = requests.get(
'https://api.bouncy.ai/v1/geo-presets',
headers={'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'}
)
data = response.json()
print(f"You have {len(data['presets'])} geo presets")
{
"success": true,
"presets": [
{
"id": "a1B2c3D4e5F6g7H8",
"name": "UK and US",
"countries": ["US", "GB"],
"createdAt": "2026-01-15T10:00:00Z",
"updatedAt": "2026-02-05T14:30:00Z"
},
{
"id": "z9Y8x7W6v5U4t3S2",
"name": "Core EU markets",
"countries": ["DE", "FR", "ES", "IT"],
"createdAt": "2026-01-20T09:00:00Z",
"updatedAt": "2026-01-20T09:00:00Z"
}
]
}
Request
Headers
A geo preset is a named, reusable country set. Presets are created and managed in the Bouncy dashboard (inside the geo filtering modal of any link or website editor). They are read-only via the API: use a preset’s
id as a rule’s presetId when creating or updating links, or as geoPresetId on bulk create rows.Response
Array of geo preset objects
Show properties
Show properties
Preset ID. Pass this as a geo rule’s
presetId when creating or updating links, or as geoPresetId on bulk create rows.The saved country list as ISO 3166-1 alpha-2 codes (e.g.,
US, GB). Presets store countries only: redirect URLs are set per rule when the preset is applied.curl https://api.bouncy.ai/v1/geo-presets \
-H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"
const response = await fetch('https://api.bouncy.ai/v1/geo-presets', {
headers: {
'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'
}
});
const { presets } = await response.json();
console.log(`You have ${presets.length} geo presets`);
import requests
response = requests.get(
'https://api.bouncy.ai/v1/geo-presets',
headers={'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'}
)
data = response.json()
print(f"You have {len(data['presets'])} geo presets")
{
"success": true,
"presets": [
{
"id": "a1B2c3D4e5F6g7H8",
"name": "UK and US",
"countries": ["US", "GB"],
"createdAt": "2026-01-15T10:00:00Z",
"updatedAt": "2026-02-05T14:30:00Z"
},
{
"id": "z9Y8x7W6v5U4t3S2",
"name": "Core EU markets",
"countries": ["DE", "FR", "ES", "IT"],
"createdAt": "2026-01-20T09:00:00Z",
"updatedAt": "2026-01-20T09:00:00Z"
}
]
}