Skip to main content
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

identifier
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

success
boolean
Whether the operation succeeded
data
object
The link object
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"
}