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)

{
  "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 }
  }
}