Samsas for developers

På svenska

Read your household's week, dinners, lists, countdowns and the kids' points from your own scripts, home automation or a screen of your own. Read-only for now; the same narrow picture as the shared screen and Home Assistant – never how anyone feels, the jar, the cycle or money.

Your keys

…

Limits

per hourper day
Free60500
Samsas Plus60010000

Counted per household, over all keys. Each answer says how many calls are left (X-RateLimit-Remaining); a 429 says in Retry-After when to go on.

Endpoints

GET /api/v1/meThe key, its household and who is in it
GET /api/v1/todayToday: events, dinner, name days and holidays, swap requests
GET /api/v1/eventsEvents, bin and post days, and a shared child's weeks, for a span of up to 93 days
GET /api/v1/menuThe week's dinners, Monday to Sunday
GET /api/v1/listsThe shopping list, the week's list, the to-do list and your own lists
GET /api/v1/countdownsBirthdays, anniversaries and events worth counting down to
GET /api/v1/kidsPer child: where they are this week, their points and this week's chores
GET /api/v1/noticesBin and post days and list deadlines, from today

The full description (OpenAPI)

Example

curl -H "Authorization: Bearer sams_…" https://samsas.app/api/v1/today