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"

{
  "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"
  }
}

​
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"

{
  "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"
  }
}