---
title: "Resolve share link"
method: GET
path: "/share_links/{identifier}"
tags: ["Share Links"]
---

# Resolve share link

`GET /share_links/{identifier}`

## Request

- Base URL: `https://api.wistia.com/modern`
- URL: `https://api.wistia.com/modern/share_links/{identifier}`
- Auth: HTTP bearer

Resolves a share link URL segment — the part after `/s/` in a share
link like `https://example.wistia.com/s/summer-sale` — to the share
link and the media it points to, including the media's hashed ID.

The identifier may be the share link's hashed ID or its custom slug.
Historical slugs that were later changed still resolve to the link.

## Requires api token with one of the following permissions
```
Read all folder and media data
```

Tokens with the "Act with a team member's permissions" permission
(`all:delegate_to_contact_permissions` scope) can also be used. Requests
made with such a token are authorized using the permissions of the
contact assigned to the token.

An [expiring access token](https://docs.wistia.com/reference/post_expiring-token)
created with the `all:delegate_to_contact_permissions` scope and an
authorization naming the share link's media (any permission) can also be
used. The share link of a media the token does not name is not found.

## Path parameters

- `identifier` string, required

## Headers

- `X-Wistia-API-Version` string, required

## Response `200`

Successful response

- object: A shareable link for a single media. Each media can have at most one share link, and the link's `visibility` controls who can view the media when visiting the link.
  - `id` string, required: The hashed ID of the share link. This appears in the link's URL.
  - `media_id` string, required: The hashed ID of the media this share link points to.
  - `url` string, uri, required: The full URL viewers can use to view the media via this share link.
  - `slug` string, nullable, required: The share link's custom slug, if one is set. When present, the slug replaces the hashed ID in the link's URL.
  - `visibility` 'unlocked' | 'account' | 'locked' | 'domain_verified', required: Controls who can view the media via this share link. - `unlocked`: anyone with the link can view the media. - `account`: only signed-in members of the media's account can view. - `locked`: only contacts with access to the media's folder can view. - `domain_verified`: only viewers signed in with an email address at a domain verified on the media's account can view. Requires the account to be enrolled in the domain validation gate; otherwise setting this value returns 400.
  - `created_at` string, date-time, required: When the share link was created.
  - `updated_at` string, date-time, required: When the share link was last updated.

## Other responses

- `401`: Unauthorized, invalid or missing token
- `404`: Resource not found
- `500`: Internal server error

## Changes

- **2026-11-03** `b86cb2a7b420`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wistia/apis/data-api/changes/share_links/:identifier/get.md)

---

[API](https://skmtc.dev/wistia/apis/data-api.md) - [All operations](https://skmtc.dev/wistia/apis/data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wistia/apis/data-api/revisions/b86cb2a7b420?raw)