> 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/objects-schema/partner-request-object.md).

# Partner Request Object

## Partner Request Object

A newsletter awaiting approval to join a publication's partner program — the pre-approval mirror of a **Partner Object**.

| Field                      | Type             | Description                                                                                               |
| -------------------------- | ---------------- | --------------------------------------------------------------------------------------------------------- |
| `uuid`                     | String           | Partner request (campaign) UUID.                                                                          |
| `status`                   | String           | Always `awaiting_approval`.                                                                               |
| `created_at`               | String           | When the request was made (ISO 8601).                                                                     |
| `recommending_publication` | String \| Object | The applicant publication's UUID; the full **Publication Object** with `expand=recommending_publication`. |
| `application_reason`       | String \| null   | The applicant's pitch.                                                                                    |
| `partner_track_record`     | Object           | The applicant's track record. Present only with `expand=partner_track_record`.                            |

**`partner_track_record`** (only with `expand=partner_track_record`)

| Field                   | Type    | Description                                             |
| ----------------------- | ------- | ------------------------------------------------------- |
| `recommendations_count` | Integer | How many publications the applicant already recommends. |
| `total_referrals_made`  | Integer | Total referrals the applicant has driven overall.       |

**Example (`expand=recommending_publication,partner_track_record`)**

```json
{
  "uuid": "prt_99cc88dd",
  "status": "awaiting_approval",
  "created_at": "2026-06-20T14:00:00.000Z",
  "recommending_publication": {
    "uuid": "pub_5fc782e24409",
    "name": "The Daily Byte",
    "description": "A daily newsletter about tech and culture.",
    "logo_url": "https://assets.sparkloop.app/logos/pub_5fc782e24409.png",
    "url": "https://thedailybyte.com"
  },
  "application_reason": "Our audience overlaps closely with yours.",
  "partner_track_record": {
    "recommendations_count": 14,
    "total_referrals_made": 5210
  }
}
```