> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bouncy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Link

> Retrieve details for a specific short link

## Request

### Headers

### Path Parameters

<ParamField path="identifier" type="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](/api-reference/links/list-links).
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Whether the operation succeeded
</ResponseField>

<ResponseField name="data" type="object">
  The link object

  <Expandable title="properties">
    <ResponseField name="id" type="string">
      Unique identifier for the link
    </ResponseField>

    <ResponseField name="url" type="string">
      The complete short URL
    </ResponseField>

    <ResponseField name="slug" type="string">
      The slug portion of the short URL
    </ResponseField>

    <ResponseField name="destination" type="string">
      The destination URL where the link redirects
    </ResponseField>

    <ResponseField name="domain" type="string">
      Domain used for the short URL
    </ResponseField>

    <ResponseField name="title" type="string">
      Link title
    </ResponseField>

    <ResponseField name="description" type="string">
      Link description
    </ResponseField>

    <ResponseField name="tags" type="array">
      Array of tags
    </ResponseField>

    <ResponseField name="groupId" type="string">
      Group ID if assigned
    </ResponseField>

    <ResponseField name="isActive" type="boolean">
      Whether the link is currently active
    </ResponseField>

    <ResponseField name="linkType" type="string">
      Link type (e.g., `app` for app links)
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      Timestamp of creation
    </ResponseField>

    <ResponseField name="updatedAt" type="string">
      Timestamp of last update
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.bouncy.ai/v1/links/my-link \
    -H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  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);
  ```

  ```python Python theme={null}
  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'])
  ```
</RequestExample>

<ResponseExample>
  ```json 200 Success theme={null}
  {
    "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"
    }
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "error": "Not Found",
    "message": "Deeplink not found"
  }
  ```

  ```json 403 Forbidden theme={null}
  {
    "error": "Forbidden",
    "message": "You do not have permission to access this deeplink"
  }
  ```
</ResponseExample>