Usual buys due

GET

/api/list/usual

curl --request GET \
  --url http://localhost:3000/api/list/usual \
  --cookie merran.session_token=<merran.session_token>

• Your Merran

What the household gets every so often, learned from the shopping it’s put away (bought on three days or more), now due again: “Milk? You last got some Oct 9.” Not what’s on the list, at home, bought every week or always on hand, nor what’s been passed over until it’s due again. With an API key, it needs the list: read permission.

Authorizations

• session
• apiKey

Responses

200

Due now.

Media typeapplication/json

object

items

required

Due now, most overdue first.

Array<object>

object

food

required

Which food it is.

string

name

required

string

amount

required

How much it was last time, or empty.

string

every

required

About how many days apart it’s bought.

integer

lastBought

required

string

/^\d{4}-\d{2}-\d{2}$/

dueOn

required

string

/^\d{4}-\d{2}-\d{2}$/

Example

{
  "items": [
    {
      "food": "milk",
      "name": "milk",
      "amount": "1 gal",
      "every": 6,
      "lastBought": "2026-10-09",
      "dueOn": "2026-10-14"
    }
  ]
}

401

Not signed in.

Media typeapplication/json

object

error

required

object

code

required

string

message

required

string

fields

object

key

additional properties

string

Example

{
  "error": {
    "code": "not_found",
    "message": "There's nothing here.",
    "fields": {
      "name": "Give it a name."
    }
  }
}

403

Not allowed.

Media typeapplication/json

object

error

required

object

code

required

string

message

required

string

fields

object

key

additional properties

string

Example

{
  "error": {
    "code": "not_found",
    "message": "There's nothing here.",
    "fields": {
      "name": "Give it a name."
    }
  }
}