The "Use perk" screen
The perk, where it works (with each location's hours now), whether it can be used now, whether the signed-in person may use it (the tier, the 7-day hold after reaching it, once per period, "Show sponsor perks", the business's own team, a sanctioned region), their use this period and when it can be used again.
Authorizations
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.
Parameters
Path Parameters
"uuid"Query Parameters
Where the phone is (lat,lng), sent only when the person already lets the site know: the storefronts come nearest first, with their distance. Never cached.
"38.574,-121.481"Responses
OK