> For the complete documentation index, see [llms.txt](https://docs.sparkloop.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sparkloop.app/api-v3/endpoints/publications/grow/partner-program/partners.md).

# Partners

## Partners

A **partner** of a publication's partner program is another newsletter that recommends it in exchange for a per-referral commission — the sponsor-side view of the same relationship a recommendation describes. Use this resource to list the program's partners, or fetch a single one by UUID. Partners awaiting approval are not included here (see **Partner Requests**).

### List partners

<mark style="color:blue;">`GET`</mark> `https://api.sparkloop.app/v3/publications/:publication_uuid/grow/partner_program/partners`

Paginated.

**Path Parameters**

| Name                                                | Type   | Description             |
| --------------------------------------------------- | ------ | ----------------------- |
| publication\_uuid<mark style="color:red;">\*</mark> | String | The publication's UUID. |

**Query Parameters**

| Name      | Type   | Description                               |
| --------- | ------ | ----------------------------------------- |
| order\_by | String | Rank partners the way the dashboard does. |
| expand    | String | `recommending_publication`, `stats`.      |
| from      | String | Start date (`YYYY-MM-DD`) for `stats`.    |
| to        | String | End date (`YYYY-MM-DD`) for `stats`.      |

{% tabs %}
{% tab title="200: OK" %}

```json
{
  "partners": [
    <Partner Object>
  ],
  "meta": {
    "per_page": 50,
    "page": 1,
    "total_pages": 1,
    "total_partners": 27
  }
}
```

{% endtab %}
{% endtabs %}

### Get partner

<mark style="color:blue;">`GET`</mark> `https://api.sparkloop.app/v3/publications/:publication_uuid/grow/partner_program/partners/:uuid`

**Path Parameters**

| Name                                                | Type   | Description             |
| --------------------------------------------------- | ------ | ----------------------- |
| publication\_uuid<mark style="color:red;">\*</mark> | String | The publication's UUID. |
| uuid<mark style="color:red;">\*</mark>              | String | The partner's UUID.     |

**Query Parameters**

| Name   | Type   | Description                          |
| ------ | ------ | ------------------------------------ |
| expand | String | `recommending_publication`, `stats`. |

{% tabs %}
{% tab title="200: OK" %}

```json
{
  "partner": <Partner Object>
}
```

{% endtab %}

{% tab title="404: Not Found" %}

```json
{
  "error": "Resource not found."
}
```

{% endtab %}
{% endtabs %}