curl https://api.bouncy.ai/v1/links/my-link \
-H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"
const response = await fetch(
'https://api.bouncy.ai/v1/links/my-link',
{
headers: {
'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'
}
}
);
const { data: link } = await response.json();
console.log(link.destination);
import requests
response = requests.get(
'https://api.bouncy.ai/v1/links/my-link',
headers={'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'}
)
link = response.json()['data']
print(link['destination'])
{
"success": true,
"data": {
"id": "my-link",
"url": "https://bouncy.ai/my-link",
"slug": "my-link",
"domain": "bouncy.ai",
"destination": "https://example.com/summer-sale",
"title": "Summer Sale 2026",
"description": "50% off everything",
"tags": ["marketing", "sale"],
"groupId": null,
"isActive": true,
"linkType": null,
"createdAt": "2026-02-01T12:00:00Z",
"updatedAt": "2026-02-05T10:30:00Z"
}
}
{
"error": "Not Found",
"message": "Deeplink not found"
}
{
"error": "Forbidden",
"message": "You do not have permission to access this deeplink"
}
Links
Get Link
Retrieve details for a specific short link
GET
/
v1
/
links
/
{identifier}
curl https://api.bouncy.ai/v1/links/my-link \
-H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"
const response = await fetch(
'https://api.bouncy.ai/v1/links/my-link',
{
headers: {
'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'
}
}
);
const { data: link } = await response.json();
console.log(link.destination);
import requests
response = requests.get(
'https://api.bouncy.ai/v1/links/my-link',
headers={'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'}
)
link = response.json()['data']
print(link['destination'])
{
"success": true,
"data": {
"id": "my-link",
"url": "https://bouncy.ai/my-link",
"slug": "my-link",
"domain": "bouncy.ai",
"destination": "https://example.com/summer-sale",
"title": "Summer Sale 2026",
"description": "50% off everything",
"tags": ["marketing", "sale"],
"groupId": null,
"isActive": true,
"linkType": null,
"createdAt": "2026-02-01T12:00:00Z",
"updatedAt": "2026-02-05T10:30:00Z"
}
}
{
"error": "Not Found",
"message": "Deeplink not found"
}
{
"error": "Forbidden",
"message": "You do not have permission to access this deeplink"
}
Request
Headers
Path Parameters
string
required
The link’s slug (e.g.,
my-link) or system domain composite (e.g., mybouncy.link__my-link).Use the slug field returned by GET /v1/links.Response
boolean
Whether the operation succeeded
object
The link object
Show properties
Show properties
string
Unique identifier for the link
string
The complete short URL
string
The slug portion of the short URL
string
The destination URL where the link redirects
string
Domain used for the short URL
string
Link title
string
Link description
array
Array of tags
string
Group ID if assigned
boolean
Whether the link is currently active
string
Link type (e.g.,
app for app links)string
Timestamp of creation
string
Timestamp of last update
curl https://api.bouncy.ai/v1/links/my-link \
-H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"
const response = await fetch(
'https://api.bouncy.ai/v1/links/my-link',
{
headers: {
'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'
}
}
);
const { data: link } = await response.json();
console.log(link.destination);
import requests
response = requests.get(
'https://api.bouncy.ai/v1/links/my-link',
headers={'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'}
)
link = response.json()['data']
print(link['destination'])
{
"success": true,
"data": {
"id": "my-link",
"url": "https://bouncy.ai/my-link",
"slug": "my-link",
"domain": "bouncy.ai",
"destination": "https://example.com/summer-sale",
"title": "Summer Sale 2026",
"description": "50% off everything",
"tags": ["marketing", "sale"],
"groupId": null,
"isActive": true,
"linkType": null,
"createdAt": "2026-02-01T12:00:00Z",
"updatedAt": "2026-02-05T10:30:00Z"
}
}
{
"error": "Not Found",
"message": "Deeplink not found"
}
{
"error": "Forbidden",
"message": "You do not have permission to access this deeplink"
}
⌘I