
Samsas for developers
På svenskaRead 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 hour | per day | |
|---|---|---|
| Free | 60 | 500 |
| Samsas Plus | 600 | 10000 |
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/me | The key, its household and who is in it |
GET /api/v1/today | Today: events, dinner, name days and holidays, swap requests |
GET /api/v1/events | Events, bin and post days, and a shared child's weeks, for a span of up to 93 days |
GET /api/v1/menu | The week's dinners, Monday to Sunday |
GET /api/v1/lists | The shopping list, the week's list, the to-do list and your own lists |
GET /api/v1/countdowns | Birthdays, anniversaries and events worth counting down to |
GET /api/v1/kids | Per child: where they are this week, their points and this week's chores |
GET /api/v1/notices | Bin and post days and list deadlines, from today |
Example
curl -H "Authorization: Bearer sams_…" https://samsas.app/api/v1/today