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

# Referral links API overview

> Create and manage custom referral links for partners. Track clicks and conversions across multiple landing pages.

Referral links are the URLs partners share to refer customers. Each partner gets a default referral link, but you can create additional custom links pointing to different landing pages for better tracking.

## Key concepts

* **Default link**: Automatically generated for each partner (e.g., `yoursite.com?ref=PARTNER_KEY`)
* **Custom link**: Additional links pointing to specific pages (e.g., pricing, features)
* **Click tracking**: Each link tracks visits and conversions independently

## Available endpoints

<CardGroup cols={2}>
  <Card title="List links" icon="list" href="/api-reference/referral-links/list">
    Get all referral links for a partner
  </Card>

  <Card title="Get link" icon="link" href="/api-reference/referral-links/get">
    Get a specific referral link's details and stats
  </Card>

  <Card title="Create link" icon="plus" href="/api-reference/referral-links/create">
    Create a custom referral link for a partner
  </Card>

  <Card title="Update link" icon="pen" href="/api-reference/referral-links/update">
    Modify a referral link's URL or settings
  </Card>

  <Card title="Delete link" icon="trash" href="/api-reference/referral-links/delete">
    Remove a custom referral link
  </Card>
</CardGroup>

## Link formats

Referral links can use different formats depending on your configuration:

| Format           | Example                                 |
| ---------------- | --------------------------------------- |
| Query parameter  | `https://yoursite.com/?ref=PARTNER_KEY` |
| Path-based       | `https://yoursite.com/PARTNER_KEY`      |
| Custom parameter | `https://yoursite.com/?via=PARTNER_KEY` |