The household's stores

GET

/api/stores

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

• Your Merran

Kroger for the household: whether the server has a Kroger app, the household’s store, how orders are collected, and the account linked to send things to its cart. With an API key, it needs the list: read permission.

Authorizations

• session
• apiKey

Responses

200

Its stores.

Media typeapplication/json

object

kroger

required

object

ready

required

The server has a Kroger developer app.

boolean

location

required

Any of:

object

object

locationId

required

string

name

required

string

banner

required

Kroger’s name for the chain: Fry’s, Ralphs, King Soopers…

string

domain

required

The banner’s site.

string

address

required

string

null

null

modality

required

Orders are picked up or delivered.

string

Allowed values: PICKUP DELIVERY

linked

required

The account whose cart things go to.

object

by

required

string | null

at

required

string format: date-time

needsRelink

required

Kroger stopped taking the linked account.

boolean

pricesCheckedAt

required

When its prices and sales were last checked.

string | null format: date-time

leanOnSales

required

How much Fill the week and the autoplan lean on deals: the household setting stores.leanOnSales.

string

Allowed values: off some lots

weeklyBudget

required

The household’s weekly budget in its store’s currency, or null: the household setting stores.weeklyBudget.

number | null

Example

{
  "kroger": {
    "ready": true,
    "location": {
      "locationId": "70500822",
      "name": "Fry's Food Stores - Phoenix",
      "banner": "Fry's",
      "domain": "frysfood.com",
      "address": "4724 N 20th St, Phoenix, AZ"
    },
    "modality": "PICKUP",
    "linked": {
      "by": "Kyle",
      "at": "2026-10-01T17:30:00.000Z"
    },
    "needsRelink": false,
    "pricesCheckedAt": null,
    "leanOnSales": "some",
    "weeklyBudget": 120
  }
}

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