GET
/
partners
/
links
Python
from dub import Dub


with Dub(
    token="DUB_API_KEY",
) as d_client:

    res = d_client.partners.retrieve_links(request={})

    assert res is not None

    # Handle response
    print(res)
[
  {
    "id": "<string>",
    "domain": "<string>",
    "key": "<string>",
    "shortLink": "<string>",
    "url": "<string>",
    "clicks": 0,
    "leads": 0,
    "sales": 0,
    "saleAmount": 0
  }
]
Partners endpoints require an Advanced plan subscription or higher.

Authorizations

​
Authorization
string
header
required

Default authentication mechanism

Query Parameters

​
partnerId
string
​
tenantId
string

Response

The retrieved partner links.

​
id
string
required

The unique ID of the short link.

​
domain
string
required

The domain of the short link. If not provided, the primary domain for the workspace will be used (or dub.sh if the workspace has no domains).

​
key
string
required

The short link slug. If not provided, a random 7-character slug will be generated.

​
shortLink
string<uri>
required

The full URL of the short link, including the https protocol (e.g. https://dub.sh/try).

​
url
string<uri>
required

The destination URL of the short link.

​
clicks
number
default:0
required

The number of clicks on the short link.

​
leads
number
default:0
required

The number of leads the short link has generated.

​
sales
number
default:0
required

The total number of sales (includes recurring sales) generated by the short link.

​
saleAmount
number
default:0
required

The total dollar value of sales (in cents) generated by the short link.