Skip to content

A perk's history​

GET
/sponsors/{key}/manage/perks/{perkId}/history

Anyone on the team who sees perks. What happened to the perk, oldest first: created, changed (a new version started), submitted, approved (by FundlyHub after a review), live, scheduled (a change or an ending that waits), changes_requested, not_approved, withdrawn, paused (now, until when and why) and stopped. by names a team member, or is {staff: true} for FundlyHub. audience is who a change that waits is told to: the followers and the perk's users in 90 days (under 10: fewer_than: 10).

Authorizations​

BearerAuth

In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.

Type
HTTP (bearer)

Parameters​

Path Parameters

key*

The sponsor's slug (an old slug resolves too) or id.

Type
string
Required
perkId*
Type
string
Required
Format
"uuid"

Responses​

OK

application/json
JSON
{
"items": [
{
"at": "string",
"kind": "string",
"by": {
"name": "string",
"staff": true
},
"title": "string",
"previous_title": "string",
"effective_at": "string",
"until": "string",
"reason": "string"
}
],
"audience": {
"count": 0,
"fewer_than": 0
}
}

Playground​

Server
Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI

Built with VitePress