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
boolean
Whether the operation succeeded
array
Array of geo preset objects
Show properties
Show properties
string
Preset ID. Pass this as a geo rule’s
presetId when creating or updating links, or as geoPresetId on bulk create rows.string
Preset name
array
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.string
ISO 8601 timestamp of creation
string
ISO 8601 timestamp of last update
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"
}
]
}
⌘I