Skip to content
merran
GitHubInstall

Merran documentation API & integrations

What recipes cost

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

What each recipe costs at the household’s Kroger store, from each line’s share of its product’s price today, where most of its lines have a price; and the household’s weekly budget. With an API key, it needs the recipes: read permission.

Its recipes’ costs.

Media typeapplication/json
object
currency
required
string
weeklyBudget
required

The household’s weekly budget, in cents, or null.

integer | null
recipes
required

By recipe id, the recipes with a cost worth showing: three in five of their lines priced.

object
key
additional properties
object
total
required

In cents.

integer
perServing
required
integer | null
priced
required

Its lines with a price.

integer
counted
required

Its lines with an amount of something bought.

integer

Example

{
"currency": "USD",
"weeklyBudget": 12000,
"recipes": {
"0199e8b0-5a10-7a01-8b00-000000000006": {
"total": 1240,
"perServing": 310,
"priced": 5,
"counted": 6
}
}
}

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."
}
}
}

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."
}
}
}

© 2026 Kyle Johnson. Documentation: CC BY 4.0. Merran: AGPL-3.0-or-later.