> 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/partner-requests.md).

# Partner Requests

## Partner Requests

A **partner request** is a newsletter asking to join a publication's partner program — a partner relationship still awaiting the sponsor's approval (status `awaiting_approval`). It carries the applicant's pitch and, on request, their track record. Approving a request turns it into a **partner**.

### List partner requests

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

Paginated.

**Path Parameters**

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

**Query Parameters**

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

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

```json
{
  "partner_requests": [
    <Partner Request Object>
  ],
  "meta": {
    "per_page": 50,
    "page": 1,
    "total_pages": 1,
    "total_partner_requests": 4
  }
}
```

{% endtab %}
{% endtabs %}

### Approve a partner request

<mark style="color:green;">`POST`</mark> `https://api.sparkloop.app/v3/publications/:publication_uuid/grow/partner_program/partner_requests/:partner_request_uuid/approval`

Approves the request, turning it into an active partner. Returns the resulting **Partner**.

**Path Parameters**

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

{% tabs %}
{% tab title="201: Created" %}

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

{% endtab %}

{% tab title="422: Unprocessable Entity" %}

```json
{
  "error": "This request could not be approved."
}
```

{% endtab %}
{% endtabs %}