> 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-object.md).

# Partner Object

## Partner Object

An active partner of a publication's partner program — a newsletter recommending it. The sponsor-side view of the same relationship a **Recommendation Object** describes.

| Field                            | Type             | Description                                                                                             |
| -------------------------------- | ---------------- | ------------------------------------------------------------------------------------------------------- |
| `uuid`                           | String           | Partner (campaign) UUID.                                                                                |
| `status`                         | String           | Partner status (e.g. `active`).                                                                         |
| `created_at`                     | String           | When the partnership began (ISO 8601).                                                                  |
| `recommending_publication`       | String \| Object | The partner publication's UUID; the full **Publication Object** with `expand=recommending_publication`. |
| `last_30_days_confirmation_rate` | Number           | The partner's confirmation rate over the last 30 days.                                                  |
| `stats`                          | Object           | Date-ranged performance. Present only with `expand=stats`.                                              |

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

| Field       | Type   | Description                                                                                |
| ----------- | ------ | ------------------------------------------------------------------------------------------ |
| `referrals` | Object | `confirmed`, `pending`, `rejected`, `total` counts.                                        |
| `spend`     | Object | What the sponsor pays this partner: `confirmed`, `estimated_pending`, `total`, in dollars. |

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

```json
{
  "uuid": "prt_11aa22bb",
  "status": "active",
  "created_at": "2025-09-01T12: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"
  },
  "last_30_days_confirmation_rate": 58.0,
  "stats": {
    "referrals": { "confirmed": 80, "pending": 20, "rejected": 5, "total": 105 },
    "spend": { "confirmed": 200.0, "estimated_pending": 35.0, "total": 235.0 }
  }
}
```